MCI_LOAD command
The MCI_LOAD command loads a file. Digital-video and video-overlay devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LOAD,
DWORD dwFlags,
(DWORD) (LPMCI_LOAD_PARMS) lpLoad
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or, for digital-video devices, MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpLoad
-
Pointer to an MCI_LOAD_PARMS structure. (Devices with additional parameters might replace this structure with a device-specific structure. For digital-video devices, the lpLoad parameter points to an MCI_DGV_LOAD_PARMS structure.)
Return Value
Returns zero if successful or an error otherwise.
Remarks
The following additional flag applies to all devices supporting MCI_LOAD:
-
MCI_LOAD_FILE
-
The lpfilename member of the structure identified by lpLoad contains an address of a buffer containing the filename.
The following additional flag is used with the overlay device type:
-
MCI_OVLY_RECT
-
The rc member of the structure identified by lpLoad contains a valid display rectangle that identifies the area of the video buffer to update.
For video-overlay devices, the lpLoad parameter points to an MCI_OVLY_LOAD_PARMS structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|