Поделиться через

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

  • Статья

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

Синтаксис

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

Параметры

[in] pIContentInfo

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

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_INVALIDREQUEST
 Вызывающий объект сделал недопустимый запрос. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Чтобы индекс правильно функционировал, необходимо вызвать этот метод после того, как все пакеты 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 .

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wmcontainer.h
Библиотека Mfuuid.lib

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

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

IMFASFIndexer

MFCreateASFIndexer