共用方式為


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
程式庫 Mfuuid.lib

另請參閱

ASF Index 物件

IMFASFIndexer

MFCreateASFIndexer