Microsoft DirectX 8.0

IAMVideoAcceleratorNotify インターフェイス

IAMVideoAcceleratorNotify インターフェイスは、ビデオ デコーダの出力ピンでサポートされている。このメソッドは、ダウンストリーム オーバーレイ ミキサーとピンが接続している間に呼び出され、IAMVideoAccelerator インターフェイスを設定する。

注 :  このインターフェイスは、Microsoft® Windows® 2000 で使用できる。

要件

Videoacc.h が必要である。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IAMVideoAcceleratorNotify メソッド説明
GetUncompSurfacesInfo 指定されたビデオ アクセラレータの GUID に関する圧縮解除されたバッファの情報を取得する。
SetUncompSurfacesInfo 圧縮されていないバッファの情報を設定する。
GetCreateVideoAcceleratorData ビデオ アクセラレータ オブジェクトの作成に必要な情報を取得する。

IAMVideoAcceleratorNotify::GetUncompSurfacesInfo

IAMVideoAcceleratorNotify

指定されたビデオ アクセラレータの GUID に対する圧縮解除されたバッファの情報を取得する。

構文

HRESULT GetUncompSurfacesInfo(
    const GUID *pGuid,
    LPAMVAUncompBufferInfo pUncomBufferInfo
);

パラメータ

pGuid
[in] 情報取得対象のビデオ アクセラレータを識別する GUID へのポインタ。
pUncompBufferInfo
[in, out] 圧縮されていないサーフェス情報を含む AMVAUncompBufferInfo 構造体へのポインタ。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。

E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_POINTERNull ポインタ引数。
S_OK成功。

注意

このメソッドを呼び出すと、ピクセル フォーマットだけでなく、サーフェスの最小数および最大数に対するビデオ デコーダの要件が返される。このメソッドは圧縮されていないデータ バッファの割り当てに必要な情報を提供する。

IAMVideoAcceleratorNotify::SetUncompSurfacesInfo

IAMVideoAcceleratorNotify

圧縮されていないバッファの情報を設定する。

構文

HRESULT SetUncompSurfacesInfo(
    DWORD  dwActualUncompSurfacesAllocated
);

パラメータ

dwActualUncompSurfacesAllocated
[in] 割り当てられるサーフェスの数。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。

E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_POINTERNull ポインタ引数。
S_OK成功。

注意

このメソッドを呼び出すと、実際に割り当てられている圧縮解除されたサーフェスの数がビデオ デコーダに通知される。

IAMVideoAcceleratorNotify::GetCreateVideoAcceleratorData

IAMVideoAcceleratorNotify

ビデオ アクセラレータ オブジェクトの作成に必要な情報を取得する。

構文

HRESULT GetCreateVideoAcceleratorData(
    const GUID *pGuid,
    LPWDORD pdwSizeMiscData,
    LPVOID *ppMiscData
);

パラメータ

pGuid
[in] ビデオ アクセラレータを識別する GUID へのポインタ。
pdwSizeMiscData
[out] ppMiscData に返されるデータのサイズ (バイト単位) を受け取る変数へのポインタ。
ppMiscData
[out] 各種のデータ (pdwSizeMiscData が 0 の場合は NULL) を受け取る void 型 のポインタへのアドレス。このポインタは CoTaskMemAlloc (COM ライブラリのヘルパー関数) で割り当てる必要がある。このアドレスは呼び出し元が解放する。「注意」を参照すること。

戻り値

インターフェイスの実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。

E_FAIL失敗。
E_INVALIDARG引数が無効。
E_NOTIMPLメソッドがサポートされていない。
E_POINTERNull ポインタ引数。
S_OK成功。

注意

このメソッドは、ビデオ アクセラレータの初期化時にビデオ デコーダがビデオ アクセラレータに送信する必要のある各種のデータへのポインタを取得する。ppMiscData について CoTaskMemFree を呼び出す操作は呼び出し元で行う。