MM_MCIPLAYLISTMESSAGE

This message notifies an application that the playlist processor has encountered a **MESSAGE** instruction.

Syntax

MsgParam1
USHORT usInstruction; /* Playlist instruction number. */
USHORT usDeviceID;    /* Device ID. */

MsgParam2
ULONG ulMessageParm;  /* Playlist parameter. */

Parameters

usInstruction (USHORT) - input

Playlist instruction number.

usDeviceID (USHORT) - input

Device ID.

ulMessageParm (ULONG) - input

Parameter specified in playlist **MESSAGE** instruction (operand 2).

Returns

rc (BOOL) - return

Success indicator.

TRUE: Successful completion.

FALSE: Error occurred. (Note: The return value is typically ignored for this posted message.)

Remarks

This message allows an application to execute custom logic when a specific point (marked by a **MESSAGE** instruction) is reached during playlist playback.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set rc to the default value of FALSE.