MCI_CUE

This MCI command message cues a device so that playback or recording begins with minimum delay. Support of this message by a device is optional. The parameters and flags for this message vary according to the selected device.

Parameters

DWORD lParam1

The following flags apply to all devices supporting MCI_CUE:

MCI_NOTIFY

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

MCI_WAIT

Specifies that the cue operation should finish before MCI returns control to the application.

LPMCI_GENERIC_PARMS lParam2

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

Waveform Audio Extensions

DWORD lParam1

The following additional flags apply to wave audio devices:

MCI_WAVE_INPUT

Specifies that a wave input device should be cued.

MCI_WAVE_OUTPUT

Specifies that a wave output device should be cued. This is the default flag if a flag is not specified.

LPMCI_GENERIC_PARMS lParam2

Specifies a far pointer to the MCI_GENERIC_PARMS data structure.

Return Value

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

See Also

MCI_SEEK, MCI_PLAY, MCI_RECORD