MCI_OPEN - Description

This message is used to open or create a new device instance.

ulParam1 (ULONG)

This parameter can contain any of the following flags. MCI_OPEN_ELEMENT and MCI_OPEN_MMIO are mutually exclusive flags.

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_DOS_QUEUE
This flag specifies that window handles passed in for this device instance will be treated as OS/2 Control Program queue handles.
MCI_OPEN_ALIAS
This flag specifies that the pszAlias field of the open structure contains an alias for this device instance. This alias can then be used on subsequent commands using the string interface.
MCI_OPEN_ELEMENT
This flag specifies that an element name is included. The element name can be that of a file or a file element in a compound file. The element name is specified in the pszElementName field of the open data structure. If the element name does not exist or is NULL, then a temporary element is created for subsequent use. The temporary file can be made permanent by providing a name using the MCI_SAVE message.
MCI_OPEN_MMIO
This flag specifies that an MMIO handle (hmmio) is passed in the pszElementName field of the open data structure. The file must have been opened through MMIO with ulTranslate of the MMIOINFO data structure set to MMIO_TRANSLATEHEADER, unless a particular MCD indicates differently.
MCI_OPEN_PLAYLIST
This flag indicates that the pszElementName field of the open data structure contains a pointer to a memory playlist structure.
MCI_OPEN_READONLY
This flag specifies that the file is to be opened in read-only mode. The load and run-time performance for the wave audio and digital video devices can be improved by specifying this flag. This flag can only be used in conjunction with the MCI_OPEN_ELEMENT or MCI_OPEN_MMIO flags. By specifying this flag, MCI_RECORD and MCI_SAVE are automatically disabled.
MCI_OPEN_SHAREABLE
This flag specifies that the device instance is to be opened in a fully shareable mode. Omitting this flag causes the device instance to be opened for exclusive use.
MCI_OPEN_TYPE_ID
This flag specifies that the pszDeviceType field of the open data structure is to be interpreted as follows. The low-order word is a standard device type and the high-order word is the ordinal index for the device. If MCI_OPEN_TYPE_ID is specified and the index is 0, the default device will be opened. If MCI_OPEN_TYPE_ID is not specified and the pszDeviceType field is not NULL, the media control interface will attempt to open the device specified by pszDeviceType. If MCI_OPEN_TYPE_ID is not specified, pszDeviceType is NULL, and the MCI_OPEN_ELEMENT flag is specified, the system attempts to select and open a device based on the element extension or EA type of the file specified in the pszElementName field of the open data structure.
Digital Video Extensions

The following flags apply to digital video devices:

MCI_DGV_OPEN_PARENT

This flag indicates that the hwndParent field of the open data structure contains a valid parent window handle. If this flag is not specified, HWND_DESKTOP is assumed to be the parent window handle.
Video Overlay Extensions

The following flag applies to video overlay devices:

MCI_OVLY_OPEN_PARENT

This flag indicates that the hwndParent field of the open data structure contains a valid parent window handle. If this flag is not specified, HWND_DESKTOP is assumed to be the parent window handle.

pParam2 (PMCI_OPEN_PARMS)

A pointer to the MCI_OPEN_PARMS data structure. Devices with extended command sets might replace this pointer with a pointer to a device-specific data structure as follows:

PMCI_AMP_OPEN_PARMS

A pointer to the MCI_AMP_OPEN_PARMS data structure.
PMCI_DGV_OPEN_PARMS
A pointer to the MCI_DGV_OPEN_PARMS data structure.
PMCI_OVLY_OPEN_PARMS
A pointer to the MCI_OVLY_OPEN_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_UNSUPPORTED_FLAG
Flag not supported by this MMPM/2 driver for this command.
MCIERR_DEVICE_LOCKED
Device is locked.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_FILE_NOT_FOUND
Filenotfound .
MCIERR _ INI _ FILE
MMPM2 . INIfileerror .
MCIERR _ OVLY _ MAX _ OPEN _ LIMIT
Openedmaximumlimit .
MCIERR _ INVALID _ MEDIA _ TYPE
Invalidmediatypegiven .
MCIERR _ HARDWARE
Hardwareerror .
MCIERR _ FILE _ ATTRIBUTE
Fileattributeerrorspecified .
MCIERR _ NO _ DEVICEDRIVER
Therewasnodevicedriverfoundoritisnotoperational .
MCIERR _ UNSUPP _ SAMPLESPERSEC
Thehardwaredoesnotsupportthissamplingrate
MCIERR _ UNSUPP _ BITSPERSAMPLE
Thehardwaredoesnotsupportthisbitspersamplesetting .
MCIERR _ UNSUPP _ CHANNELS
Thehardwaredoesnotsupportthischannelsetting .
MCIERR _ UNSUPP _ FORMAT _ MODE
Thehardwaredoesnotsupportthisformatmode .
MCIERR _ UNSUPP _ FORMAT _ TAG
Thehardwaredoesnotsupportthisformattag .
MMIOERR _ ACCESS _ DENIED
Thefilecannotbeopened .

---

[Back: MCI_OPEN Return Value - rc]
[Next: MCI_OPEN - Remarks]