IWMIndexer2
COM公式ドキュメント
IWMIndexer2 インターフェイスを使用すると、インデクサーオブジェクトの設定を必要に応じて変更できます。このインターフェイスはインデクサーオブジェクトの一部として実装されています。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Configure メソッドは、インデクサーオブジェクトの内部設定を変更します。
| wStreamNum | WORD | in | インデックスを作成するストリーム番号を格納した WORD です。0 を渡すと、すべてのストリームがインデックス化されます。 |
| nIndexerType | WMT_INDEXER_TYPE | in | WMT_INDEXER_TYPE 列挙型のメンバーを 1 つ格納した変数です。 |
| pvInterval | void* | in | この void ポインターは、目的のインデックス作成間隔を格納した DWORD を指している必要があります。時間ベースのインデックス作成では間隔はミリ秒単位です。フレームベースのインデックス作成間隔はフレーム単位で指定します。 NULL を渡すと、Configure は既定値を使用します。時間ベースのインデックスの場合、既定値は 3000 ミリ秒、フレームベースのインデックスの場合は 10 フレームです。 |
| pvIndexType | void* | in | この void ポインターは、WMT_INDEX_TYPE 列挙型のメンバーを 1 つ格納した WORD 値を指している必要があります。NULL を渡すと、Configure は既定値を使用します。 既定値は WMT_IT_NEAREST_CLEAN_POINT です。別のインデックスの種類を使用すると、シーク性能が低下します。 |
戻り値
このメソッドは HRESULT を返します。戻り値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| メソッドは内部リストにストリーム番号を追加できません。 |
解説(Remarks)
ファイル内の複数のストリームを構成するために、Configure を必要な回数だけ呼び出すことができます。インデックス作成を開始する前に、必要なすべての Configure の呼び出しを行う必要があります。既にインデックスを持つファイルを構成してインデックス化すると、既存のインデックスは削除されます。
フレームベースのインデックスを作成するようにインデクサーを構成すると、時間ベースのインデックスも作成されます。これは音声と映像を同期させるために必要です。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMIndexer2 "{B70F1E42-6255-4DF0-A6B9-02B212D9E2BB}"
#usecom global IWMIndexer2 IID_IWMIndexer2 "{}"
#comfunc global IWMIndexer2_Configure 5 int,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。