MCI_CUE コマンド

  • [アーティクル]

MCI_CUE コマンドは、再生または記録が最小遅延で開始されるようにデバイスをキューに入れます。 デジタル ビデオ、VCR、波形オーディオ デバイスはこのコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオおよび VCR デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpCue

MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

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

解説

digitalvideo デバイスの種類では、次の追加フラグが使用されます。

MCI_DGV_CUE_INPUT

デジタル ビデオ インスタンスは、記録の準備をする必要があります。 アプリケーションでディスク領域が予約されていない場合、デバイスは既定のパラメーターを使用してディスク領域を予約します。 現在のプレゼンテーション ソースが既に外部入力である場合、アプリケーションはこのフラグを省略できます。 (このフラグは、プレゼンテーション ソースの選択には影響しません)。

MCI_DGV_CUE_NOSHOW

デジタル ビデオ インスタンスは、コマンドで指定されたフレームを表示せずに再生する準備をする必要があります。 このフラグを指定すると、対応するフレームが現在の位置ではない場合でも、ディスプレイはフレーム バッファーに画像を表示し続けます。 たとえば、フレーム バッファーにフレーム 7 からのイメージが含まれている場合、このフラグを使用してデバイスを他の位置にキューに入れると、デバイスはフレーム 7 を表示し続けます。 このフラグを指定せず、MCI_TO フラグを指定しない後続のキュー コマンドは、現在のフレームを表示します。

MCI_DGV_CUE_OUTPUT

デジタル ビデオ インスタンスは、再生の準備をする必要があります。 ワークスペースが一時停止されている場合、配置は行われません。 ワークスペースが停止している場合、位置が前のキー フレーム イメージに変わる可能性があります。 現在のプレゼンテーション ソースが既にワークスペースである場合、アプリケーションはこのフラグを省略できます。

MCI_TO

ワークスペースの位置は、lpCue によって識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられる単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグを使用して指定します。 これは、コマンドの後にデバイスが一時停止される点を除き、位置をシークする場合と同じです。

digitalvideo デバイスの場合、lpCue パラメーターはMCI_DGV_CUE_PARMS構造体を指します。

vcr デバイスの種類では、次の追加フラグが使用されます。

MCI_FROM

lpCue が指す構造体の dwFrom メンバーには、現在の時刻形式で指定された開始位置が含まれています。

MCI_TO

lpCue が指す構造体の dwTo メンバーには、現在の時刻形式で指定された終了位置 (一時停止) が含まれています。

MCI_VCR_CUE_INPUT

記録の準備をします。

MCI_VCR_CUE_OUTPUT

プレイの準備をします。 MCI_VCR_CUE_INPUTもMCI_VCR_CUE_OUTPUTも指定されていない場合は、MCI_VCR_CUE_OUTPUTが想定されます。

MCI_VCR_CUE_PREROLL

デバイスを現在の位置( dwFrom 位置)からプリロール期間を差し引いた位置にキューを設定します。 これにより、デバイスは、レコードまたは再生モードに入る前に自身を準備できます。

MCI_VCR_CUE_REVERSE

次の再生コマンドまたはレコード コマンドの方向が逆になります。

MCI_VCR_CUE_OUTPUT フラグを指定して MCI_CUE コマンドを使用して再生を開始する場合は、MCI_FROM、MCI_TO、または MCI_VCR_PLAY_REVERSEで MCI_PLAY コマンドを発行して、MCI_CUEを取り消すことができます。

MCI_VCR_CUE_INPUT フラグでMCI_CUEを使用して記録を開始する場合は、MCI_FROM、MCI_TO、またはMCI_VCR_RECORD_INITIALIZEを使用して MCI_RECORD コマンドを発行して、MCI_CUEを取り消すことができます。

vcr デバイスの場合、lpCue パラメーターはMCI_VCR_CUE_PARMS構造体を指します。

waveaudio デバイスの種類では、次の追加フラグが使用されます。

MCI_WAVE_INPUT

波形オーディオ入力デバイスを接続する必要があります。

MCI_WAVE_OUTPUT

波形オーディオ出力デバイスを接続する必要があります。 フラグが指定されていない場合、これは既定のフラグです。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

関連項目

Mci

MCI コマンド