Microsoft DirectX 8.0

IAMOverlayFX インターフェイス

IAMOverlayFX インターフェイスは、オーバーレイ ミキサー フィルタで実装される。このインターフェイスによって、アプリケーションは、ユーザーの画面上でのビデオ オーバーレイの表示方法を制御できる。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterfaceサポートされているインターフェイスへのポインタを取得する。
AddRef参照カウントをインクリメントする。
Release参照カウントをデクリメントする。
IAMOverlayFX メソッド説明
QueryOverlayFXCapsオーバーレイ ミキサー フィルタで有効なオーバーレイ エフェクトに関する情報を取得する。
SetOverlayFX指定のエフェクトをオーバーレイ サーフェスに適用する。
GetOverlayFXオーバーレイ サーフェスに現在適用されているエフェクトがある場合は、これを取得する。

IAMOverlayFX::GetOverlayFX

IAMOverlayFX インターフェイス

オーバーレイ サーフェスに現在適用されているエフェクトがある場合は、これを取得する。アプリケーションでは、フィルタ グラフの実行中にこのメソッドを呼び出すことができる。

構文

HRESULT GetOverlayFX(
    DWORD *lpdwOverlayFX
);

パラメータ

lpdwOverlayFX
[out] オーバーレイ サーフェスに現在適用されているエフェクトがある場合、これを示す値を受け取る変数へのポインタ。値は、AMOVERLAYFX 列挙型のフラグの論理和である。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。Microsoft® DirectShow® の実装では、成功の場合は S_OK を返す。NULL ポインタ引数の場合は E_POINTER を返す。

IAMOverlayFX::SetOverlayFX

IAMOverlayFX インターフェイス

指定のエフェクトをオーバーレイ サーフェスに適用する。

構文

HRESULT SetOverlayFX(
    DWORD dwOverlayFX
);

パラメータ

dwOverlayFX
[in] 適用するエフェクトを指定する値。値は、AMOVERLAYFX 列挙型フラグの論理和でなければならない。それ以外の場合、メソッドは E_INVALIDARG を返す。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。 DirectShow の実装では、次のいずれかの値、またはこれ以外の値を返す。

E_FAIL失敗。
E_INVALIDARG無効な引数。
S_OK成功。

注意

アプリケーションは、フィルタ グラフの実行中にこのメソッドを呼び出す必要がある。エフェクトは即時に適用される。

IAMOverlayFX::QueryOverlayFXCaps

IAMOverlayFX インターフェイス

オーバーレイ ミキサー フィルタで有効なオーバーレイ エフェクトに関する情報を取得する。

構文

HRESULT QueryOverlayFXCaps(
    DWORD *lpdwOverlayFXCaps
);

パラメータ

lpdwOverlayFXCaps
[out] オーバーレイ サーフェスのオーバーレイ エフェクト機能を示す値を受け取る変数へのポインタ。値は、AMOVERLAYFX 列挙型フラグの論理和である。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。DirectShow の実装では、次のいずれかの値を返す。

E_FAIL失敗。
E_POINTERNull ポインタ引数。
S_OK成功。