MM_MCINOTIFY訊息

MM_MCINOTIFY訊息會通知應用程式 MCI 裝置已完成作業。 只有在使用 MCI_NOTIFY 旗標時,MCI 裝置才會傳送此訊息。

MM_MCINOTIFY 
wParam = (WPARAM) wFlags 
lParam = (LONG) lDevID

參數

wFlags

通知的原因。 已定義下列值:

需求
MCI_NOTIFY_ABORTED 裝置收到一個命令,導致無法符合起始回呼函式的目前條件。 如果新的命令中斷目前的命令,而且也會要求通知,裝置只會傳送此訊息,而不會MCI_NOTIFY_SUPERSEDED
MCI_NOTIFY_FAILURE 裝置執行命令時發生裝置錯誤。
MCI_NOTIFY_SUCCESSFUL 已符合起始回呼函式的條件。
MCI_NOTIFY_SUPERSEDED 裝置收到另一個已設定「通知」旗標的命令,並已取代起始回呼函式的目前條件。

lDevID

起始回呼函式之裝置的識別碼。

傳回值

如果成功或發生錯誤,則傳回零。

備註

如需MCI_NOTIFY旗標的詳細資訊,請參閱 通知旗標

當命令的動作完成時,裝置會傳回 具有MM_MCINOTIFY的MCI_NOTIFY_SUCCESSFUL 旗標。 例如,CD 音訊裝置會在裝置完成播放時,使用此旗標來通知播放 ( MCI_PLAY) 命令。 只有在到達指定的結束位置或到達媒體結尾時, 播放 命令才會成功。 同樣地,搜尋 ( MCI_SEEK) 記錄 ( MCI_RECORD) 命令不會傳回MCI_NOTIFY_SUCCESSFUL,直到它們到達指定的結束位置或到達媒體的結尾為止。

只有在裝置收到防止它符合通知條件的命令時,裝置才會傳回 具有MM_MCINOTIFY的MCI_NOTIFY_ABORTED 旗標。 例如,如果新命令不會變更播放方向或變更結束位置, 則播放 命令不會中止先前 播放 命令的通知。 搜尋記錄命令的行為類似。 使用 暫停 ( MCI_PAUSE) 命令暫停播放或錄製時,MCI 也不會傳送MCI_NOTIFY_ABORTED。 傳送 繼續 ( MCI_RESUME) 命令可讓他們繼續符合回呼條件。

當您的應用程式要求命令通知時,請檢查 mciSendStringmciSendCommand 函式的錯誤傳回。 如果這些函式發生錯誤並傳回非零值,MCI 將不會設定命令的通知。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Mmsystem.h (包含 Windows.h)

另請參閱

Mci

MCI 訊息

暫停

record

恢復

尋求