MCI_PAUSE
The MCI_PAUSE
command pauses the current action. CD audio, digital-video, MIDI sequencer,
VCR, videodisc, and waveform-audio devices recognize this command.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID,
MCI_PAUSE,
DWORD dwFlags, (DWORD)
(LPMCI_GENERIC_PARMS) lpPause);
Parameters
wDeviceID
Device
identifier of the MCI device that is to receive the command message.
dwFlags
MCI_NOTIFY,
MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For information
about these flags, see The Wait, Notify, and Test Flags.
lpPause
Address of an
MCI_GENERIC_PARMS
structure. (Devices with extended command sets might replace this structure
with a device-specific structure.)
Return Values
Returns zero
if successful or an error otherwise.
Remarks
The
difference between the MCI_STOP and MCI_PAUSE commands depends on the device. If
possible, MCI_PAUSE suspends device operation but leaves the device
ready to resume play immediately. With the MCICDA, MCISEQ, and MCIPIONR
drivers, the MCI_PAUSE command works the same as the MCI_STOP
command.
For digital-video
devices, the lpPause parameter points to an MCI_DGV_PAUSE_PARMS structure.
See Also