realize コマンド

realize コマンドは、表示されたウィンドウの表示コンテキストにそのパレットを選択して実現するようにデバイスに指示します。デジタルビデオデバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszPalette

次のいずれかのフラグ。

値	説明
background	パレットを背景パレットとして実現します。
普通	トップレベルウィンドウのパレットを実現します。これが既定の設定です。

lpszFlags

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

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

このコマンドは、アプリケーションがウィンドウハンドルを使用し、 WM_QUERYNEWPALLETTE または WM_PALETTECHANGED メッセージを受信する場合にのみ使用します。

次のコマンドは、"myvideo" デバイスにそのパレットを実現するように指示します。

realize myvideo normal

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