MM_MCINOTIFY

This message notifies an application when a device completes the action indicated by a media message or when an error occurs.

Syntax

MsgParam1
USHORT usNotifycode;    /* Notification code. */
USHORT usUserParameter; /* User parameter. */

MsgParam2
USHORT usDeviceID;      /* Device ID. */
USHORT usMessage;       /* Message ID. */

Parameters

usNotifycode (USHORT) - input

Specifies the following notification message code:

• MCI_NOTIFY_SUCCESSFUL The command was completed successfully.
• MCI_NOTIFY_SUPERSEDED Another notification request (same type of command) was received.
• MCI_NOTIFY_ABORTED The command was interrupted and is unable to be completed. For example, the first command was a PLAY with notify, and the second command was STOP with or without notify.

Any other value indicates an error, and that value is the error number. mciGetErrorString can be used to convert the number into a textual description of the error.

usUserParameter (USHORT) - input

Contains the user parameter specified on mciSendCommand or mciSendString for this command.

usDeviceID (USHORT) - input

The media control interface device ID included in the notification.

usMessage (USHORT) - input

Specifies the message ID which generated the notification.

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 is posted to the window specified in the hwndCallback field of the parameter data structure used with the command (e.g., MCI_PLAY, MCI_RECORD, etc.).

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.