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

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

  • Статья

Извлекает параметры индекса для указанного потока и типа индекса.

Синтаксис

HRESULT GetIndexStatus(
  [in]      ASF_INDEX_IDENTIFIER *pIndexIdentifier,
  [out]     BOOL                 *pfIsIndexed,
  [out]     BYTE                 *pbIndexDescriptor,
  [in, out] DWORD                *pcbIndexDescriptor
);

Параметры

[in] pIndexIdentifier

Указатель на структуру ASF_INDEX_IDENTIFIER , содержащую номер потока и тип индекса, для которого требуется получить состояние.

[out] pfIsIndexed

Переменная, извлекающая логическое значение, указывающее, был ли создан индекс, описываемый pIndexIdentifier .

[out] pbIndexDescriptor

Буфер, получающий дескриптор индекса. Дескриптор индекса состоит из структуры ASF_INDEX_DESCRIPTOR , за которой при необходимости следуют данные, относящиеся к индексу.

[in, out] pcbIndexDescriptor

При входе указывает размер буфера, на который указывает pbIndexDescriptor (в байтах). Значение может быть равным нулю, если pbIndexDescriptor имеет значение NULL. В выходных данных получает размер дескриптора индекса в байтах.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_BUFFERTOOSMALL
 Размер буфера, указанный в pcbIndexDescriptor , слишком мал.

Комментарии

Чтобы прочитать существующий индекс ASF, вызовите IMFASFIndexer::SetIndexByteStreams перед вызовом этого метода.

Если для потока существует индекс, а значение, переданное в pcbIndexDescriptor , меньше требуемого размера буфера pbIndexDescriptor , метод возвращает MF_E_BUFFERTOOSMALL. Требуемый размер буфера возвращается в параметре pcbIndexDescriptor .

Если для указанного потока нет индекса, метод возвращает значение FALSE в параметре pfIsIndexed .

Требования

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

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

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

IMFASFIndexer