Microsoft DirectX 8.0

IAMVfwCompressDialogs インターフェイス

IAMVfwCompressDialogs インターフェイスは、AVI コンプレッサ フィルタで実装される。このインターフェイスによって、アプリケーションは Video for Windows CODEC の [Configure] または [About] ダイアログ ボックスを表示し、コンプレッサ状態の設定と取得を行うことができる。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IAMVfwCompressDialogs methods説明
ShowDialog 指定されたダイアログ ボックスを表示する。
GetState 現在使用されている VCM CODEC の現在の構成設定を取得する。
SetState VCM CODEC の構成を設定する。
SendDriverMessage ドライバ固有のメッセージを送信する。

IAMVfwCompressDialogs::GetState

IAMVfwCompressDialogs インターフェイス

現在使用されている VCM CODEC の現在の構成設定を取得する。

構文

HRESULT GetState(

  LPVOID pState,
  int *pcbState

パラメータ

pState
[out] VCM CODEC の状態。
pcbState
[in, out] ステート情報のサイズへのポインタ。

戻り値

戻り値は、各ドライバ内の実装に応じて異なる。

注意

このメソッドは、COM ICGetState マクロを呼び出す。

IAMVfwCompressDialogs::SendDriverMessage

IAMVfwCompressDialogs インターフェイス

ドライバ固有のメッセージを送信する。

構文

HRESULT SendDriverMessage(
  int uMsg,
  long dw1,
  long dw2 );

パラメータ

uMsg
[in] ドライバに送信するメッセージ。
dw1
[in] メッセージ データ。
dw2
[in] メッセージ データ。

戻り値

戻り値は、各ドライバ内の実装に応じて異なる。

注意

このメソッドを使用する必要はない。このメソッドを使用すると、任意のプライベート メッセージをビデオ コンプレッサ (CODEC) に送信できる。ただし、任意のメッセージに応答する動作が決められていない場合があるので、このメソッドはユーザーの責任において使用すること。

このメソッドは、Video for Windows のビデオ圧縮マネージャ (VCM) の ICSendMessage 関数を呼び出してメッセージを送信する。

IAMVfwCompressDialogs::SetState

IAMVfwCompressDialogs インターフェイス

VCM CODEC の構成を設定する。

構文

HRESULT SetState(
  LPVOID pState,
  int cbState );

パラメータ

pState
[in] VCM CODEC の状態。
cbState
[in] ステート情報のサイズ。

戻り値

戻り値は、各ドライバ内の実装に応じて異なる。

注意

このメソッドは、COM ICSetState マクロを呼び出す。このマクロは、ビデオ圧縮ドライバにコンプレッサの状態を設定するように通知する。

IAMVfwCompressDialogs::ShowDialog

IAMVfwCompressDialogs インターフェイス

指定されたダイアログ ボックスを表示する。

構文

HRESULT ShowDialog(
  int iDialog,
  long hwnd );

パラメータ

iDialog
[in] 表示するダイアログ ボックス。このダイアログ ボックスは VfwCompressDialogs 列挙型のメンバである。
hwnd
[in] ダイアログ ボックスの親ウィンドウのハンドル。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。

注意

目的のドライバがストリーミング中または別のダイアログ ボックスを表示している場合に、ダイアログ ボックスの表示を要求すると、このメソッドはエラーを返す。ドライバがダイアログ ボックスを表示している間は、フィルタをストリーム (停止または実行) できない。

IAMVfwCompressDialogs::ShowDialog は Video for Windows のビデオ圧縮マネージャ (VCM) の関数 ICConfigureICAboutICQueryConfigure、および ICQueryAbout を呼び出し、該当するダイアログ ボックスを表示するか、またはそのダイアログ ボックスが存在するかどうかを確認する。

VfwCompressDialogs 列挙型の VfwCompressDialog_QueryConfig および VfwCompressDialog_QueryAbout メンバによって、Configure ダイアログまたは About ダイアログが使用可能かどうかがわかる。この 2 つのフラグのいずれかが渡されると、フィルタはダイアログが存在する場合は S_OK を返し、存在しない場合は S_FALSE を返す。ダイアログが利用可能な場合、値 VfwCompressDialog_Config または VfwCompressDialog_About を指定して ShowDialog を呼び出し、ダイアログを表示する。