stop コマンド
stop コマンドは、再生または記録を停止します。 CD オーディオ、デジタル ビデオ、MIDI シーケンサー、videodisc、VCR、波形オーディオ デバイスは、このコマンドを認識します。
このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。
_stprintf_s(
lpszCommand,
TEXT("stop %s %s %s"),
lpszDeviceID,
lpszStopFlags,
lpszFlags
);
パラメーター
-
lpszDeviceID
-
MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。
-
lpszStopFlags
-
デジタル ビデオ デバイスの場合は、次のフラグを指定できます。
値 説明 保持 画面上の静止画像を再描画するために必要なリソースが解放されないようにします。 フレーム バッファーは、ウィンドウが移動された場合など、ディスプレイの更新に使用できます。 -
lpszFlags
-
"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
解説
CD オーディオ デバイスの場合、stop コマンドは再生を停止し、現在のトラック位置を 0 にリセットします。
例
次のコマンドは、"mysound" デバイスでの再生または記録を停止します。
stop mysound
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |