Метод IMFASFIndexer::CommitIndex (wmcontainer.h)

Добавляет сведения о новом индексе в объект ContentInfo, связанный с содержимым ASF. Этот метод необходимо вызвать перед копированием индекса в содержимое, чтобы индекс был удобочитаемым индексатором позже.

Синтаксис

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

Параметры

[in] pIContentInfo

Указатель на интерфейс IMFASFContentInfo объекта ContentInfo, описывающего содержимое.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Комментарии

Чтобы индекс правильно функционировал, необходимо вызвать этот метод после того, как все пакеты ASF в файле были переданы индексатору с помощью метода IMFASFIndexer::GenerateIndexEntries . После вызова этого метода необходимо получить индексы, вызвав Метод GetCompletedIndex , и записать их в соответствующее расположение в файле. Наконец, необходимо создать новый заголовок ASF, вызвав метод IMFASFContentInfo::GenerateHeader объекта ASF ContentInfo.

Приложение должно использовать метод CommitIndex только при записи нового индекса, в противном случае CommitIndex может возвращать MF_E_INVALIDREQUEST в результате. Например, MF_E_INVALIDREQUEST возвращается, если в приложении установлены флаги, отличные от MFASF_INDEXER_WRITE_NEW_INDEX для объекта индексатора. CommitIndex также может возвращать MFASF_INDEXER_WRITE_NEW_INDEX, если записи индекса уже были зафиксированы с помощью более раннего вызова CommitIndex .

Этот метод нельзя использовать в сценарии чтения индекса. Этот метод можно использовать только при записи индексов.

Требования

См. также раздел

Объект индекса ASF

IMFASFIndexer

MFCreateASFIndexer