MCI_OPEN コマンド

MCI_OPEN コマンドは、デバイスまたはファイルを初期化します。 すべてのデバイスでこのコマンドが認識されます。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_OPEN, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_OPEN_PARMS) lpOpen
);

パラメーター

wDeviceID

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

dwFlags

MCI_NOTIFYまたはMCI_WAIT。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpOpen

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

戻り値

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

解説

mciSendCommand 関数でデバイスが指定されるたびに、MCI_OPEN_TYPE フラグを使用する必要があります。 デバイスの種類の定数を指定してデバイスを開く場合は、MCI_OPEN_TYPEに加えて、MCI_OPEN_TYPE_ID フラグを指定する必要があります。 デバイスの種類の定数の一覧については、「 MCI デバイスの種類」を参照してください。

デバイスまたはファイルを最初に開いたときにMCI_OPEN_SHAREABLE フラグが指定されていない場合、デバイスまたはファイルに対する後続のすべてのMCI_OPENコマンドは失敗します。 デバイスまたはファイルが既に開いている場合、このフラグが指定されていない場合、最初の open コマンドがMCI_OPEN_SHAREABLE指定された場合でも、呼び出しは失敗します。 MCISEQ 用に開かれたファイル。DRV と MCIWAVE。DRV デバイスは共有できません。

デバイス名では大文字と小文字は無視されますが、先頭または末尾に空白を指定することはできません。

(レジストリのエントリを使用して) 自動型選択を使用するには、lpOpen で識別される構造体の lpstrElementName メンバーにファイル名とファイル拡張子を割り当て、lpstrDeviceType メンバーを NULL に設定し、MCI_OPEN_ELEMENT フラグを設定します。

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

MCI_OPEN_ALIAS

エイリアスは、lpOpen によって識別される構造体の lpstrAlias メンバーに含まれます。

MCI_OPEN_SHAREABLE

デバイスまたはファイルは共有可能として開く必要があります。

MCI_OPEN_TYPE

lpOpen で識別される構造体の lpstrDeviceType メンバーには、デバイスの種類の名前または定数が含 まれています。

MCI_OPEN_TYPE_ID

lpOpen によって識別される構造体の lpstrDeviceType メンバーの下位ワードには、標準の MCI デバイスの種類識別子が含まれており、高次ワードには必要に応じて、デバイスの序数インデックスが含まれます。 このフラグは、MCI_OPEN_TYPE フラグと共に使用します。

複合デバイスには、次の追加フラグが適用されます。

MCI_OPEN_ELEMENT

ファイル名は、lpOpen によって識別される構造体の lpstrElementName メンバーに含まれます。

MCI_OPEN_ELEMENT_ID

lpOpen によって識別される構造体の lpstrElementName メンバーは DWORD 値として解釈され、デバイスの内部的な意味を持ちます。 このフラグは、MCI_OPEN_ELEMENT フラグと共に使用します。

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

MCI_DGV_OPEN_NOSTATIC

デバイスは、パレット内の静的 (システム) 色の数を減らす必要があります。 これにより、ビデオ ストリームのレンダリングに使用できる色の数が増えます。 このフラグは、パレットを Windows と共有するデバイスにのみ適用されます。

MCI_DGV_OPEN_PARENT

親ウィンドウ ハンドルは、lpOpen によって識別される構造体の hWndParent メンバーで指定されます。

MCI_DGV_OPEN_WS

ウィンドウ スタイルは、lpOpen によって識別される構造体の dwStyle メンバーで指定されます。

MCI_DGV_OPEN_16BIT

16 ビット MCI デバイスのサポートの優先順位を示します。

MCI_DGV_OPEN_32BIT

32 ビット MCI デバイスのサポートの優先順位を示します。

デジタル ビデオ デバイスの場合、 lpOpen パラメーターは MCI_DGV_OPEN_PARMS 構造体を指します。

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

MCI_OVLY_OPEN_PARENT

親ウィンドウ ハンドルは、lpOpen によって識別される構造体の hWndParent メンバーで指定されます。

MCI_OVLY_OPEN_WS

ウィンドウ スタイルは、lpOpen によって識別される構造体の dwStyle メンバーで指定されます。 dwStyle 値は、ドライバーが作成するウィンドウのスタイルを指定し、アプリケーションがウィンドウを提供しない場合に表示します。 style パラメーターは、ウィンドウ スタイルを定義する整数を受け取ります。 これらの定数は、標準のウィンドウ スタイル (WS_CHILD、WS_OVERLAPPEDWINDOW、WS_POPUPなど) と同じです。

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

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

MCI_WAVE_OPEN_BUFFER

バッファー長は、lpOpen で識別される構造体の dwBufferSeconds メンバーで指定されます。

波形オーディオ デバイスの場合、 lpOpen パラメーターは MCI_WAVE_OPEN_PARMS 構造体を指します。 MCIWAVE ドライバーには、非同期の波形オーディオ デバイスが必要です。

必要条件

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

関連項目

Mci

MCI コマンド