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 [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

こちらもご覧ください

Mci

MCI コマンド