MCI_PAUSE

This MCI command message pauses a play or record operation.

Parameters

DWORD lParam1

The following flags apply to all devices supporting MCI_PAUSE:


MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that the device should be paused before MCI returns control to the application.

LPMCI_DGV_PAUSE_PARMS lParam2

Specifies a far pointer to the MCI_DGV_PAUSE_PARMS data structure. (Devices with extended command sets might replace this data structure with a device-specific data structure.)

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

This command pauses the playing or recording of motion video or audio. The last displayed image remains visible and the device driver instance remains cued. The play, record, and resume commands continue the operation of a paused device. If the MCI_DGV_RECORD_HOLD flag is specified for recording, pausing a device also executes the MCI_MONITOR command with the file option. This stops the presentation of audio and video data from the external input providing a visual cue that recording is paused.

See Also

MCI_PLAY, MCI_RECORD, MCI_RESUME, MCI_STOP