IMFASFIndexer::CommitIndex 方法 (wmcontainer.h)
将有关新索引的信息添加到与 ASF 内容关联的 ContentInfo 对象。 在将索引复制到内容之前,必须调用此方法,以便索引器稍后可读取索引。
语法
HRESULT CommitIndex(
[in] IMFASFContentInfo *pIContentInfo
);
参数
[in] pIContentInfo
指向描述内容的 ContentInfo 对象的 IMFASFContentInfo 接口的指针。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
调用方发出的请求无效。 有关详细信息,请参阅“备注”。 |
注解
若要使索引正常运行,必须在使用 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 |