MCI_PLAY コマンド

MCI_PLAYコマンドは、出力データの送信を開始するようにデバイスに通知します。 CD オーディオ、デジタル ビデオ、MIDI シーケンサー、videodisc、VCR、波形オーディオ デバイスは、このコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

パラメーター

wDeviceID

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

dwFlags

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

lpPlay

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

戻り値

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

解説

次の追加フラグは、MCI_PLAYをサポートするすべてのデバイスに適用されます。

MCI_FROM

開始位置は、lpPlay で識別される構造体の dwFrom メンバーに含まれています。 位置の値に割り当てられる単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグで指定されます。 MCI_FROMが指定されていない場合、開始位置は既定で現在の位置になります。

MCI_TO

終了位置は、lpPlay によって識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられた単位は、MCI_SETのMCI_SET_TIME_FORMAT フラグで指定されます。 MCI_TOが指定されていない場合、終了位置は既定でメディアの末尾になります。

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

MCI_DGV_PLAY_REPEAT

コンテンツの末尾に達すると、再生は最初から再度開始されます。

MCI_DGV_PLAY_REVERSE

再生は逆に行われます。

MCI_MCIAVI_PLAY_WINDOW

再生は、デバイス インスタンスに関連付けられているウィンドウで行う必要があります (既定値)。 (このフラグは MCIAVI に固有です。DRV.)

MCI_MCIAVI_PLAY_FULLSCREEN

再生には全画面表示を使用する必要があります。 このフラグは、圧縮ファイルまたは 8 ビット ファイルを再生する場合にのみ使用します。

デジタル ビデオ デバイスの場合、 lpPlay は MCI_DGV_PLAY_PARMS 構造を指します。

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

MCI_VCR_PLAY_AT

lpPlay によって識別される構造体の dwAt メンバーには、コマンド全体が開始される時刻、またはデバイスがMCI_CUE コマンドによって指定された from 位置に達した時刻が含まれます。

MCI_VCR_PLAY_REVERSE

再生は逆に行われます。

MCI_VCR_PLAY_SCAN

ビデオ出力を維持しながら、可能な限り高速に再生する必要があります。

VCR デバイスの場合、 lpPlay は MCI_VCR_PLAY_PARMS 構造体を指します。

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

MCI_VD_PLAY_FAST

高速再生。

MCI_VD_PLAY_REVERSE

逆に再生します。

MCI_VD_PLAY_SCAN

すばやくスキャンします。

MCI_VD_PLAY_SLOW

ゆっくり再生します。

MCI_VD_PLAY_SPEED

再生速度は、lpPlay で識別される構造体の dwSpeed メンバーに含まれます。

必要条件

関連項目

Mci

MCI コマンド