IMFASFIndexer：：CommitIndex 方法 (wmcontainer.h)

  • 项目

将有关新索引的信息添加到与 ASF 内容关联的 ContentInfo 对象。 在将索引复制到内容之前，必须调用此方法，以便索引器稍后可读取索引。

语法

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

参数

[in] pIContentInfo

指向描述内容的 ContentInfo 对象的 IMFASFContentInfo 接口的指针。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
MF_E_INVALIDREQUEST
 调用方发出的请求无效。 有关详细信息，请参阅“备注”。

注解

若要使索引正常运行，必须在使用 IMFASFIndexer：：GenerateIndexEntries 方法将文件中的所有 ASF 数据包传递到索引器后调用此方法。 调用此方法后，必须通过调用 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 索引对象

IMFASFIndexer

MFCreateASFIndexer