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 [デスクトップアプリのみ]
ヘッダー	Mmsystem.h (Windows.h を含む)