play コマンド

再生コマンドは、デバイスの再生を開始します。 CD オーディオ、デジタル ビデオ、MIDI シーケンサー、videodisc、VCR、波形オーディオ デバイスは、このコマンドを認識します。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszPlayFlags

デバイスを再生するためのフラグ。 次の表に、 play コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
cdaudio	from position	to position
digitalvideo	位置から全画面表示の繰り返し	ウィンドウの 位置を反転する
sequencer	from position	to position
ビデオデッキ	位置反転からの時刻	スキャンして位置を指定する
videodisc	位置逆スキャンから高速	低速整数から位置へ
waveaudio	from position	to position

次の表に、 lpszPlayFlags パラメーターで指定できるフラグとその意味を示します。

値	説明
時刻	デバイスがこのコマンドの実行を開始するタイミングを示します。または、cued コマンドの開始時にデバイスが実行されている場合は を示します。 詳細については、 キュー コマンドを参照してください。
fast	デバイスが通常よりも速く再生されることを示します。 videodisc プレーヤーの正確な速度を確認するには、 status コマンドの "speed" フラグを使用します。 速度をより正確に指定するには、このコマンドの "speed" フラグを使用します。
from position	再生の開始位置を指定します。 "from" フラグが指定されていない場合、再生は現在の位置から開始されます。 cdaudio デバイスの場合、"from" 位置がディスクの終了位置より大きい場合、または "from" 位置が "to" 位置より大きい場合、ドライバーはエラーを返します。 videodisc デバイスの場合、既定の位置は CAV ディスクのフレーム内にあり、CLV ディスクの場合は時間、分、秒です。
フルスクリーン	全画面表示を使用することを指定します。 このフラグは、圧縮ファイルを再生する場合にのみ使用します。 (圧縮されていないファイルは全画面で再生されません。
repeat	コンテンツの末尾に達したときに再生を再開することを指定します。
reverse	再生方向が逆方向であることを指定します。 終了位置を "reverse" フラグで指定することはできません。 videodiscs の場合、"スキャン" は CAV 形式にのみ適用されます。
scan	ビデオを無効にせずに可能な限り高速に再生します (ただし、オーディオは無効になっている可能性があります)。 videodiscs の場合、"スキャン" は CAV 形式にのみ適用されます。
slow	再生速度が遅い。 videodisc プレーヤーの正確な速度を確認するには、 status コマンドの "speed" フラグを使用します。 速度をより正確に指定するには、このコマンドの "speed" フラグを使用します。 videodiscs の場合、"slow" は CAV 形式にのみ適用されます。
speed integer	指定した速度 (1 秒あたりのフレーム数) でビデオディスクを再生します。 このフラグは、CAV ディスクにのみ適用されます。
to position	再生の終了位置を指定します。 "to" フラグが指定されていない場合、再生はコンテンツの末尾で停止します。 cdaudio デバイスの場合、"to" 位置がディスクの終了位置より大きい場合、ドライバーはエラーを返します。 videodisc デバイスの場合、既定の位置は CAV ディスクのフレーム内にあり、CLV ディスクの場合は時間、分、秒です。
window	デバイス インスタンスに関連付けられているウィンドウを再生で使用することを指定します。 これが既定の設定です。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

注釈

位置値を使用するコマンドを発行する前に、set コマンドを使用して目的の時刻形式を 設定 する必要があります。 このコマンドは、設定された "speed" コマンドで設定されているように、現在の速度で再生を開始します。 "reverse" フラグが指定されている場合、または "to" フラグが "from" フラグより小さい値として指定されている場合、方向は逆になります。 "from" フラグが指定されていない場合、再生は現在の位置から開始されます。 "to" フラグと "reverse" フラグを一緒に使用することはできません。

例

次のコマンドは、位置 1000 から位置 2000 までの "mysound" デバイスを再生し、再生が完了したときに通知メッセージを送信します。

play mysound from 1000 to 2000 notify

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]

こちらもご覧ください

Mci

MCI コマンド文字列

キュー

set