ACQUIRE

The ACQUIRE command acquires use of the physical resources for the device. The EXCLUSIVE and EXCLUSIVE INSTANCE keywords cannot be used together.

Syntax

ACQUIRE ──── object ────┬──────────────────────┬──┬─────────┬──
                        ├─ EXCLUSIVE ──────────┤  └─ QUEUE ─┘
                        └─ EXCLUSIVE INSTANCE ─┘

─┬──────────┬─────────────────────────────────────────────────┤
 ├─ WAIT   ─┤
 └─ NOTIFY ─┘

Keywords

object

Object associated with this media control interface command. The object can be one of the following:

Device type
Device name
Filename
Alias

EXCLUSIVE: Acquires the physical resource for exclusive use. If the resource is not available, MCIERR_DEVICE_IN_USE is returned. :Exclusive use of a device can be released with the RELEASE system command.

EXCLUSIVE INSTANCE: Acquires the device such that whether being used or not, it cannot be made inactive by another request.
QUEUE: Queues ACQUIRE command to be executed when device resources become available.
WAIT: The command is executed synchronously. The function waits until the requested action is complete before returning to the application.
NOTIFY: The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Example

acquire digitalvideo exclusive wait