MCI_STOP コマンド
MCI_STOP コマンドは、すべての再生シーケンスとレコード シーケンスを停止し、すべての再生バッファーをアンロードし、ビデオ 画像の表示を停止します。 CD オーディオ、デジタル ビデオ、MIDI シーケンサー、videodisc、VCR、波形オーディオ デバイスは、このコマンドを認識します。
このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_STOP,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpStop
);
パラメーター
-
wDeviceID
-
コマンド メッセージを受信する MCI デバイスのデバイス識別子。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオおよび VCR デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
-
lpStop
-
MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
解説
MCI_STOPコマンドと MCI_PAUSE コマンドの違いは、デバイスによって異なります。 可能であれば、MCI_PAUSEはデバイス操作を中断しますが、デバイスはすぐに再生を再開する準備が整います。
CDオーディオデバイスの場合、MCI_STOPは現在のトラック位置をゼロにリセットします。これに対 し、MCI_PAUSE は現在のトラック位置を維持し、デバイスが再生を再開することを予測します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|