Microsoft DirectX 8.0 |
IAMOverlayFX インターフェイスは、オーバーレイ ミキサー フィルタで実装される。このインターフェイスによって、アプリケーションは、ユーザーの画面上でのビデオ オーバーレイの表示方法を制御できる。
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを取得する。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IAMOverlayFX メソッド 説明 QueryOverlayFXCaps オーバーレイ ミキサー フィルタで有効なオーバーレイ エフェクトに関する情報を取得する。 SetOverlayFX 指定のエフェクトをオーバーレイ サーフェスに適用する。 GetOverlayFX オーバーレイ サーフェスに現在適用されているエフェクトがある場合は、これを取得する。
オーバーレイ サーフェスに現在適用されているエフェクトがある場合は、これを取得する。アプリケーションでは、フィルタ グラフの実行中にこのメソッドを呼び出すことができる。
構文
HRESULT GetOverlayFX( DWORD *lpdwOverlayFX );
パラメータ
- lpdwOverlayFX
- [out] オーバーレイ サーフェスに現在適用されているエフェクトがある場合、これを示す値を受け取る変数へのポインタ。値は、AMOVERLAYFX 列挙型のフラグの論理和である。
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。Microsoft® DirectShow® の実装では、成功の場合は S_OK を返す。NULL ポインタ引数の場合は E_POINTER を返す。
指定のエフェクトをオーバーレイ サーフェスに適用する。
構文
HRESULT SetOverlayFX( DWORD dwOverlayFX );
パラメータ
- dwOverlayFX
- [in] 適用するエフェクトを指定する値。値は、AMOVERLAYFX 列挙型フラグの論理和でなければならない。それ以外の場合、メソッドは E_INVALIDARG を返す。
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。 DirectShow の実装では、次のいずれかの値、またはこれ以外の値を返す。
E_FAIL 失敗。 E_INVALIDARG 無効な引数。 S_OK 成功。
注意
アプリケーションは、フィルタ グラフの実行中にこのメソッドを呼び出す必要がある。エフェクトは即時に適用される。
オーバーレイ ミキサー フィルタで有効なオーバーレイ エフェクトに関する情報を取得する。
構文
HRESULT QueryOverlayFXCaps( DWORD *lpdwOverlayFXCaps );
パラメータ
- lpdwOverlayFXCaps
- [out] オーバーレイ サーフェスのオーバーレイ エフェクト機能を示す値を受け取る変数へのポインタ。値は、AMOVERLAYFX 列挙型フラグの論理和である。
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。DirectShow の実装では、次のいずれかの値を返す。
E_FAIL 失敗。 E_POINTER Null ポインタ引数。 S_OK 成功。