MM_MCINOTIFY メッセージ
MM_MCINOTIFY メッセージは、MCI デバイスが操作を完了したことをアプリケーションに通知します。 MCI デバイスは、MCI_NOTIFY フラグが使用されている場合にのみ、このメッセージを送信します。
MM_MCINOTIFY
wParam = (WPARAM) wFlags
lParam = (LONG) lDevID
パラメーター
-
wFlags
-
通知の理由。 次の値が定義されています。
要件 値 MCI_NOTIFY_ABORTED デバイスは、コールバック関数を開始するための現在の条件を満たさないようにするコマンドを受信しました。 新しいコマンドによって現在のコマンドが中断され、通知も要求された場合、デバイスはこのメッセージのみを送信し、MCI_NOTIFY_SUPERSEDED MCI_NOTIFY_FAILURE デバイスがコマンドを実行しているときに、デバイス エラーが発生しました。 MCI_NOTIFY_SUCCESSFUL コールバック関数を開始する条件が満たされています。 MCI_NOTIFY_SUPERSEDED デバイスは、"notify" フラグが設定された別のコマンドを受け取り、コールバック関数を開始するための現在の条件が置き換えられます。 -
lDevID
-
コールバック関数を開始するデバイスの識別子。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
注釈
MCI_NOTIFY フラグの詳細については、「 通知フラグ」を参照してください。
デバイスは、コマンドのアクションが完了したときに 、MM_MCINOTIFY を含むMCI_NOTIFY_SUCCESSFUL フラグを返します。 たとえば、CD オーディオ デバイスは、デバイスの再生が完了したときに 再生 ( MCI_PLAY) コマンドの通知にこのフラグを使用します。 play コマンドは、指定した終了位置に達したとき、またはメディアの末尾に達した場合にのみ成功します。 同様に、 seek ( MCI_SEEK) コマンドと record ( MCI_RECORD) コマンドは、指定した終了位置に達するか、メディアの末尾に到達するまで、MCI_NOTIFY_SUCCESSFULを返しません。
デバイスは、通知条件を満たさないようにするコマンドを受け取った場合にのみ 、MM_MCINOTIFY を含むMCI_NOTIFY_ABORTED フラグを返します。 たとえば、新しいコマンドが再生方向を変更したり、終了位置を変更したりしない場合、 play コマンドは前の 再生 コマンドの通知を中止しません。 seek コマンドと record コマンドも同様に動作します。 また、一 時停止 ( MCI_PAUSE) コマンドを使用して再生または記録を一時停止しても、MCI は MCI_NOTIFY_ABORTEDを送信しません。 resume ( MCI_RESUME) コマンドを送信すると、コールバック条件を引き続き満たすことができます。
アプリケーションがコマンドの通知を要求したら、mciSendString または mciSendCommand 関数のエラーリターンをチェックします。 これらの関数でエラーが発生し、0 以外の値が返された場合、MCI はコマンドの通知を設定しません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|