MCI_RESUME
This message is sent to resume playing or recording from a paused state.
Syntax
param1 ULONG ulParam1; /* Message flags. */ param2 PMCI_GENERIC_PARMS pParam2; /* Pointer to the MCI_GENERIC_PARMS structure. */
Parameters
- ulParam1 (ULONG) - input
- The following flags can be used:
- MCI_NOTIFY Posts a notification message when the action completes.
- MCI_WAIT Does not return control until the action is completed.
- pParam2 (PMCI_GENERIC_PARMS) - input
- A pointer to the MCI_GENERIC_PARMS structure.
Returns
- rc (ULONG) - returns
-
- MCIERR_SUCCESS If the function succeeds, 0 is returned.
- MCIERR_INVALID_DEVICE_ID The device context is not valid.
- MCIERR_INSTANCE_INACTIVE The device context is currently inactive. Issue MCI_ACQUIREDEVICE to make device context active.
- MCIERR_UNSUPPORTED_FLAG Specified flag is unsupported for this device.
- MCIERR_INVALID_CALLBACK_HANDLE Specified callback handle is invalid.
- MCIERR_UNSUPPORTED_FUNCTION Unsupported function.
- MCIERR_INVALID_FLAG Flag (ulParam1) is invalid.
- MCIERR_FLAGS_NOT_COMPATIBLE Flags cannot be used together.
Remarks
When this message is issued, the previously specified to parameter (from the original MCI_PLAY or MCI_RECORD command) remains in effect.
Example Code
The following code illustrates how to resume a paused operation.
USHORT usDeviceID;
HWND hwndMyWindow;
MCI_GENERIC_PARMS mciGenericParms; /* Generic message
parms structure */
/* Resume the previous operation that was paused */
/* Assign hwndCallback the handle to the PM Window routine */
mciGenericParms.hwndCallback = hwndMyWindow;
mciSendCommand( usDeviceID, /* Device ID */
MCI_RESUME, /* MCI resume message */
MCI_NOTIFY, /* Flag for this message */
(PVOID) &mciGenericParms, /* Data structure */
0); /* No user parm */