cue コマンド

キューコマンドは、再生または記録の準備をします。デジタルビデオ、VCR、波形オーディオデバイスは、このコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("cue %s %s %s"), 
  lpszDeviceID, 
  lpszInOutTo, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszInOutTo

再生または記録用にデバイスを準備するフラグ。次の表に、 キュー コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

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

値	説明
from position	開始する場所を示します。
input	記録の準備をします。デジタルビデオデバイスの場合、現在のプレゼンテーションソースが既に外部入力である場合は、このフラグを省略できます。
noshow	フレームを表示せずに再生する準備をします。このフラグを指定すると、対応するフレームが現在の位置ではない場合でも、ディスプレイはフレームバッファー内のイメージを引き続き表示します。このフラグを指定せず、"to" フラグを指定しない後続のキューコマンドでは、現在のフレームが表示されます。
output	プレイの準備をします。 "input" も "output" も指定されていない場合、既定の設定は "output" です。
プリロール	インポイントからプリロール距離を移動します。インポイントは、現在の位置、または "from" フラグで指定された位置です。
reverse	再生方向が逆方向 (後方) であることを示します。
to position	ワークスペースを指定した位置に移動します。 VCR デバイスの場合、このフラグは停止する場所を示します。

lpszFlags

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

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

必須ではありませんが、一部のデバイスで再生または記録する前にキューコマンドを発行すると、デバイスがアクションを開始するまでの遅延が減少する可能性があります。

再生中または記録中の場合、またはデバイスが一時停止している場合、このコマンドは失敗します。

(cue "output" を使用して) 再生用にキューを設定する場合、"from"、"to"、または "reverse" フラグを使用して再生コマンドを発行すると、キューコマンドが取り消されます。

(キュー "input" を使用して) 記録をキューに入れると、"from"、"to"、または "initialize" フラグを使用して record コマンドを発行すると、キューコマンドが取り消されます。

次のコマンドは、"mysound" デバイスを記録用に準備します。

cue mysound input

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