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

  • [アーティクル]

ASF コンテンツに関連付けられている ContentInfo オブジェクトに新しいインデックスに関する情報を追加します。 インデックスをコンテンツにコピーする前に、このメソッドを呼び出して、インデクサーが後でインデックスを読み取ることができるようにする必要があります。

構文

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

パラメーター

[in] pIContentInfo

コンテンツを記述する ContentInfo オブジェクトの IMFASFContentInfo インターフェイスへのポインター。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_INVALIDREQUEST
 呼び出し元が無効な要求を行いました。 詳細については、「解説」を参照してください。

注釈

インデックスが正しく機能するには、ファイル内のすべての ASF パケットが IMFASFIndexer::GenerateIndexEntries メソッドを使用してインデクサーに渡された後で、このメソッドを呼び出す必要があります。 このメソッドを呼び出した後、 GetCompletedIndex を呼び出してインデックスを取得し、ファイル内の適切な場所に書き込む必要があります。 最後に、ASF ContentInfo オブジェクトの IMFASFContentInfo::GenerateHeader メソッドを呼び出して、新しい ASF ヘッダーを生成する必要があります。

アプリケーションでは、新しいインデックスを書き込む場合にのみ CommitIndex メソッドを使用する必要があります。それ以外の場合 、CommitIndex は結果としてMF_E_INVALIDREQUESTを返す可能性があります。 たとえば、アプリケーションがインデクサー オブジェクトに設定MFASF_INDEXER_WRITE_NEW_INDEX以外のフラグがある場合、MF_E_INVALIDREQUESTが返されます。 以前の CommitIndex 呼び出しでインデックス エントリが既にコミットされている場合は、 CommitIndex はMFASF_INDEXER_WRITE_NEW_INDEXを返すこともできます。

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wmcontainer.h
Library Mfuuid.lib

こちらもご覧ください

ASF Index オブジェクト

IMFASFIndexer

MFCreateASFIndexer