IAMVideoDecimationProperties
COM公式ドキュメント
IAMVideoDecimationProperties インターフェイスは、Overlay Mixer がビデオのデシメーション(間引き)をどのように実行するかを制御します。ビデオウィンドウが表示対象のビデオのネイティブサイズよりも小さい場合、ビデオレンダラーは入力ビデオをデシメーションする、つまり小さいサイズに縮小する必要があります。デシメーションは次のいずれかの場所で実行できます。VGA チップ上のオーバーレイハードウェア。ビデオポートに内蔵されたスケーラー(接続がビデオポート経由の場合)。レンダラーにビデオを供給するデコーダー。アプリケーションは、パフォーマンスを最適化するために、このインターフェイスのメソッドを呼び出して特定のデシメーション戦略を選択できます。ただし、ほとんどのアプリケーションではこのインターフェイスを使用する機会はありません。特定のハードウェアをサポートするように設計されたアプリケーションでない限り、Overlay Mixer フィルターのデシメーションに関する既定の動作を変更する理由はありません。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
QueryDecimationUsage メソッドは、現在のデシメーション戦略を取得します。
| lpUsage | DECIMATION_USAGE* | out | デシメーション設定を受け取る DECIMATION_USAGE 型の変数へのポインター。 |
戻り値
インターフェイスの実装に依存する HRESULT 値を返します。DirectShow の実装では、成功した場合は S_OK を返し、それ以外の場合は E_FAIL またはその他のエラーコードを返します。
SetDecimationUsage メソッドは、デシメーション戦略を設定します。
| Usage | DECIMATION_USAGE | in | デシメーション戦略を指定する DECIMATION_USAGE 列挙体のメンバー。 |
戻り値
インターフェイスの実装に依存する HRESULT 値を返します。DirectShow の実装では、成功した場合は S_OK を返し、それ以外の場合は E_INVALIDARG を返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IAMVideoDecimationProperties "{60D32930-13DA-11D3-9EC6-C4FCAEF5C7BE}" #usecom global IAMVideoDecimationProperties IID_IAMVideoDecimationProperties "{}" #comfunc global IAMVideoDecimationProperties_QueryDecimationUsage 3 var #comfunc global IAMVideoDecimationProperties_SetDecimationUsage 4 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IAMVideoDecimationProperties "{60D32930-13DA-11D3-9EC6-C4FCAEF5C7BE}" #usecom global IAMVideoDecimationProperties IID_IAMVideoDecimationProperties "{}" #comfunc global IAMVideoDecimationProperties_QueryDecimationUsage 3 sptr #comfunc global IAMVideoDecimationProperties_SetDecimationUsage 4 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。