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) 命令可讓他們繼續符合回呼條件。
當您的應用程式要求命令通知時,請檢查 mciSendString 或 mciSendCommand 函式的錯誤傳回。 如果這些函式發生錯誤並傳回非零值,MCI 將不會設定命令的通知。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
標頭 |
|