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