window コマンド

ウィンドウ コマンドは、表示ウィンドウを制御します。 このコマンドを使用すると、ウィンドウの表示特性を変更したり、ドライバーが既定の表示ウィンドウの代わりに使用する宛先ウィンドウを指定したりできます。 デジタル ビデオ デバイスとビデオ オーバーレイ デバイスは、このコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
); 

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszWindowFlags

表示ウィンドウを制御するためのフラグ。 次の表に、ウィンドウ コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

説明 説明
digitalvideo handle hwnd state hidestate minimizestate restorestate showshow maximized show minimizedshow min noactiveshow nashow noactivateshow normaltext caption
overlay fixedhandle defaulthandle hwnd state hidestate iconicdstate minimizedstate minimizeedstate no actionstate noactivatestate normal state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext caption

次の表に、 lpszWindowFlags パラメーターで指定できるフラグとその意味を示します。

説明
固定 イメージのストレッチを無効にします。
ハンドルの既定値 いている操作中 に作成された既定のウィンドウに、デバイスが表示ウィンドウを戻す必要があることを指定します。 ビデオ オーバーレイ デバイスの場合は、デバイスが独自の宛先ウィンドウを作成して管理する必要があることを指定します。
handle hwnd 既定のウィンドウの代わりに使用する変換先ウィンドウのハンドルを指定します。 hwnd パラメーターには、CreateWindow 関数によって返されるウィンドウ ハンドルに相当する ASCII 数値が含まれています。 2 つのデバイス インスタンスは、各インスタンスがウィンドウ内のビデオとイメージのピクセルを、もう一方のインスタンスが存在しないかのように更新する場合、同じウィンドウ ハンドルを使用できます。 setvideo "off" でビデオ出力が無効になっている場合、更新コマンドを実行すると、変換先の四角形が単色になります。
最大化表示 変換先ウィンドウを最大化します。
min noactive 表示する 移動先ウィンドウをアイコンとして表示します。
最小化された表示 変換先ウィンドウを最小化します。
show na ターゲット ウィンドウを現在の状態で表示します。現在アクティブなウィンドウはアクティブなままになります。
noactivate の表示 コピー先ウィンドウを最新のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなままになります。
標準を表示する コピー先ウィンドウを元のサイズと位置でアクティブ化して表示します。 (これは"状態の復元" フラグと同じです)。
状態の非表示 コピー先ウィンドウを非表示にします。
state iconic 移動先ウィンドウをアイコンとして表示します。
状態が最大化 変換先ウィンドウを最大化します。
state minimize コピー先ウィンドウを最小化し、ウィンドウ マネージャーの一覧で最上位のウィンドウをアクティブにします。
最小化された状態 変換先ウィンドウを最小化します。
アクションなし状態 変換先ウィンドウを現在の状態で表示します。 現在アクティブなウィンドウはアクティブなままになります。
state noactivate コピー先ウィンドウを最新のサイズと状態で表示します。 現在アクティブなウィンドウはアクティブなままです。
state normal コピー先ウィンドウを元のサイズと位置でアクティブ化して表示します。
状態の復元 コピー先ウィンドウを元のサイズと位置でアクティブ化して表示します。
state show 変換先ウィンドウを表示します。
伸縮 イメージのストレッチを有効にします。
テキスト キャプション 変換先ウィンドウのキャプションを指定します。 このテキストに埋め込みブランクが含まれている場合は、キャプション全体を引用符で囲む必要があります。 既定のウィンドウの既定のキャプションは空白です。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオ デバイスの場合は、"test" も指定できます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

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

解説

ビデオ オーバーレイ デバイスは、通常、開いたときにウィンドウを作成して表示します。 アプリケーションがドライバーにウィンドウを提供する場合、アプリケーションはウィンドウに送信されるメッセージを管理する役割を担います。

status コマンドを使用してドライバー表示ウィンドウのハンドルを取得できるため、標準のウィンドウ マネージャー関数 (ShowWindow など) を使用してウィンドウを操作することもできます。

次のコマンドは、"ムービー" 再生ウィンドウのキャプションを表示および設定します。

window movie text "Welcome to the Movies" state show

必要条件

要件
サポートされている最小のクライアント
Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]

関連項目

MCI

MCI コマンド文字列

open

play

setvideo

update