MCI_LOAD コマンド

MCI_LOAD コマンドは、ファイルを読み込みます。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LOAD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_LOAD_PARMS) lpLoad
);

パラメーター

wDeviceID

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

dwFlags

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

lpLoad

MCI_LOAD_PARMS構造体へのポインター。 (追加のパラメーターを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります。デジタル ビデオ デバイスの場合、 lpLoad パラメーターは MCI_DGV_LOAD_PARMS 構造体を指します)。

戻り値

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

解説

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

MCI_LOAD_FILE

lpLoad によって識別される構造体の lpfilename メンバーには、ファイル名を含むバッファーのアドレスが含まれています。

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

MCI_OVLY_RECT

lpLoad で識別される構造体の rc メンバーには、更新するビデオ バッファーの領域を識別する有効な表示四角形が含まれています。

ビデオ オーバーレイ デバイスの場合、 lpLoad パラメーターは MCI_OVLY_LOAD_PARMS 構造体を指します。

必要条件

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

関連項目

Mci

MCI コマンド