IMFASFIndexer::SetIndexStatus メソッド (wmcontainer.h)

ストリームのインデックスを構成します。

構文

HRESULT SetIndexStatus(
  [in] BYTE  *pbIndexDescriptor,
  [in] DWORD cbIndexDescriptor,
  [in] BOOL  fGenerateIndex
);

[in] pbIndexDescriptor

設定するインデックス記述子。インデックス記述子は ASF_INDEX_DESCRIPTOR 構造体であり、必要に応じてインデックス固有のデータが続きます。

[in] cbIndexDescriptor

インデックス記述子のサイズ (バイト単位)。

[in] fGenerateIndex

ブール値です。インデックス記述子で指定されたストリームに対して指定された型のインデックスをインデクサーで作成するには 、TRUE に設定します。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDREQUEST	シークのみのシナリオでインデックスの状態を変更しようとしました。詳細については、「解説」を参照してください。

IMFASFIndexer::GenerateIndexEntries を呼び出す前に、SetIndexStatus のすべての呼び出しを行う必要があります。

インデクサーオブジェクトは、既定で各ストリームのテンポラルインデックスを作成するように構成されています。既定の設定をオーバーライドする場合にのみ、このメソッドを呼び出します。

このメソッドは、インデックス読み取りシナリオでは使用できません。このメソッドは、インデックスを作成する場合にのみ使用できます。