BOOL APIENTRY
mciDriverNotify (
HANDLE hwndCallback,
MCIDEVICEID wDeviceID,
UINT uStatus
);
MCI drivers call mciDriverNotify to post an MM_MCINOTIFY message to an application.
Parameters
hwndCallback
Specifies the handle of the window to notify. The handle is obtained from the dwCallback member of the structure pointed to by the DriverProc lParam2 parameter.
wDeviceID
Specifies the device ID. This is the device ID received from DriverProc.
uStatus
Specifies the status of the operation requested by the application. Can be one of the following values:
| MCI_NOTIFY_SUCCESSFUL | Driver successfully completed the requested operation. |
| MCI_NOTIFY_SUPERSEDED | Application sent an MCI message with the MCI_NOTIFY flag set, then sent a second message with MCI_NOTIFY set before the first operation completed. Driver calls mciNotifyDriver with MCI_NOTIFY_SUPERSEDED status, then calls mciNotifyDriver again when the second operation completes. |
| MCI_NOTIFY_ABORTED | Application sent a command that prevents the notification condition from being satisfied. For example, the command “stop vcr1” cancels a pending notification for “play vcr1 to 500 notify”. |
| MCI_NOTIFY_FAILURE | A device error prevented the notification condition from being satisfied. |
Return Value
If a notification is successfully sent, mciDriverNotify returns TRUE; otherwise, it returns FALSE.
Comments
Drivers call mciDriverNotify after an operation has completed, if the application that requested the operation included the MCI_NOTIFY flag with the command. See Handling the MCI_NOTIFY Flag.