stop

stop コマンドは、デバイスの再生（演奏）または録音を停止します。CDオーディオ、デジタルビデオ、MIDIシーケンサ、ビデオディスク、VCR、ウェーブ形式オーディオの各デバイスがこのコマンドを認識します。

このコマンドを送信するには、 mciSendString 関数を使います。

stop device stopflag flag

引数

device

MCIデバイスの識別子を指定します。この識別名またはエイリアスは、デバイスがオープンされるときに割り当てられます。

stopflag

デジタルビデオデバイスでのみ、以下のパラメータを指定することができます。

パラメータ	意味	デバイス
hold	スクリーン上の静止画を再描画するために必要なリソースが解放されないようにします。例えばウィンドウが移動されたときなどに、再描画に使用することができるように、フレームバッファは利用可能なまま残されます。	digitalvideo

flag

何も記述しないか、“wait”、“notify”のいずれか、またはこの両方を記述します。デジタルビデオおよびVCRデバイスでは、“test”を記述することもできます。

パラメータ	意味
wait	アプリケーションに制御を返す前に、要求された指示を完了するまで待機します。
notify	デバイスが作業を完了したときに、ウィンドウに MM_MCINOTIFY メッセージをポストします。
test	デバイスがコマンドを実行することができるかどうかを判定します。コマンドは実際に実行されません。デバイスがコマンドを処理できない場合にはエラーが返ります。デジタルビデオおよびVCRデバイスでのみ指定できます。

戻り値

成功すると 0 が返ります。

失敗するとエラーコードが返ります。

解説

CDオーディオデバイスでは、再生が停止されて、現在のトラックポジションが 0 にリセットされます。

対応情報

Windows 95 以降 / Windows NT 3.1 以降