MCI_PLAY

This MCI command message signals the device to begin transmitting output data. 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_PLAY:

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 lpPlay.

MCI_WAIT

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

MCI_FROM

Specifies that a starting position is included in the dwFrom field of the data structure identified by lpPlay. The units assigned to the position values is specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. If MCI_FROM is not specified, the starting position defaults to the current location.

MCI_TO

Specifies that an ending position is included in the dwTo field of the data structure identified by lpPlay. The units assigned to the position values is specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. If MCI_TO is not specified, the end position defaults to the end of the media.

LPMCI_PLAY_PARMS lParam2

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

Animation Extensions

DWORD lParam1

The following additional flags apply to animation devices:

MCI_ANIM_PLAY_FAST

Specifies to play fast.

MCI_ANIM_PLAY_REVERSE

Specifies to play in reverse.

MCI_ANIM_PLAY_SCAN

Specifies to scan quickly.

MCI_ANIM_PLAY_SLOW

Specifies to play slowly.

MCI_ANIM_PLAY_SPEED

Specifies that the play speed is included in the dwSpeed field in the data structure identified by lParam2.

LPMCI_ANIM_PLAY_PARMS lParam2

Specifies a far pointer to an MCI_ANIM_PLAY_PARMS data structure.

Videodisc Extensions

DWORD lParam1

The following additional flags apply to videodisc devices:

MCI_VD_PLAY_FAST

Specifies to play fast.

MCI_VD_PLAY_REVERSE

Specifies to play in reverse.

MCI_VD_PLAY_SCAN

Specifies to scan quickly.

MCI_VD_PLAY_SLOW

Specifies to play slowly.

MCI_VD_PLAY_SPEED

Specifies that the play speed is included in the dwSpeed field in the data structure identified by lParam2.

LPMCI_VD_PLAY_PARMS lParam2

Specifies a far pointer to an MCI_VD_PLAY_PARMS data structure.

Return Value

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

See Also

MCI_CUE, MCI_PAUSE, MCI_RECORD, MCI_RESUME, MCI_SEEK, MCI_STOP