MCI_WINDOW コマンド
MCI_WINDOW コマンドは、グラフィック・デバイスのウィンドウおよびウィンドウ特性を指定します。 デジタル ビデオ デバイスとビデオ オーバーレイ デバイスは、このコマンドを認識します。
このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_WINDOW,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);
パラメーター
-
wDeviceID
-
コマンド メッセージを受信する MCI デバイスのデバイス識別子。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオ デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
-
lpWindow
-
MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
注釈
グラフィック デバイスは、デバイスを開いたときに既定のウィンドウを作成する必要がありますが、 MCI_PLAY コマンドを受け取るまで表示しないでください。 MCI_WINDOW コマンドは、アプリケーションで作成されたウィンドウをデバイスに提供し、アプリケーション定義または既定の表示ウィンドウの表示特性を変更するために使用されます。 アプリケーションが表示ウィンドウを提供する場合は、ウィンドウ上の無効な四角形を更新するように準備する必要があります。
digitalvideo デバイスの種類では、次の追加フラグが使用されます。
-
MCI_DGV_WINDOW_HWND
-
変換先として使用するために必要なウィンドウのハンドルは、lpWindow によって識別される構造体の hWnd メンバーに含まれます。
-
MCI_DGV_WINDOW_STATE
-
lpWindow によって識別される構造体の nCmdShow メンバーには、ウィンドウの状態を設定するためのパラメーターが含まれています。
-
MCI_DGV_WINDOW_TEXT
-
lpWindow によって識別される構造体の lpstrText メンバーには、ウィンドウ タイトル バーで使用されるキャプションを含むバッファーのアドレスが含まれています。
デジタル ビデオ デバイスの場合、 lpWindow パラメーターは MCI_DGV_WINDOW_PARMS 構造体を指します。
オーバーレイ デバイスの種類では、次の追加フラグが使用されます。
-
MCI_OVLY_WINDOW_DISABLE_STRETCH
-
イメージのストレッチを無効にします。
-
MCI_OVLY_WINDOW_ENABLE_STRETCH
-
イメージのストレッチを有効にします。
-
MCI_OVLY_WINDOW_HWND
-
変換先に使用されるウィンドウのハンドルは、lpWindow によって識別される構造体の hWnd メンバーに含まれます。 このフラグを MCI_OVLY_WINDOW_DEFAULT に設定すると、既定のウィンドウに戻ります。
-
MCI_OVLY_WINDOW_STATE
-
lpWindow 構造体の nCmdShow メンバーには、ウィンドウの状態を設定するためのパラメーターが含まれています。 このフラグは、state パラメーターを使用して ShowWindow を呼び出すことと同じです。 定数は、WINDOWS で定義されているものと同じです。H (SW_HIDE、SW_MINIMIZE、SW_SHOWNORMALなど)。
-
MCI_OVLY_WINDOW_TEXT
-
lpWindow によって識別される構造体の lpstrText メンバーには、ウィンドウに使用されるキャプションを含むバッファーのアドレスが含まれています。
ビデオ オーバーレイ デバイスの場合、 lpWindow パラメーターは MCI_OVLY_WINDOW_PARMS 構造体を指します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|