Метод IMFASFStreamConfig::GetPayloadExtension (wmcontainer.h)

Статья
08/28/2023

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

Синтаксис

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

Параметры

[in] wPayloadExtensionNumber

Индекс расширения полезных данных. Допустимые индексы варьируются от 0 до одного меньше числа расширений, полученных путем вызова IMFASFStreamConfig::GetPayloadExtensionCount.

[out] pguidExtensionSystemID

Получает GUID, идентифицирующий расширение полезных данных. Список стандартных расширений полезных данных см. в разделе GUID расширения полезных данных ASF. Приложения также могут определять пользовательские расширения полезных данных.

[out] pcbExtensionDataSize

Получает количество байтов, добавленных к каждой выборке для расширения.

[out] pbExtensionSystemInfo

Указатель на буфер, который получает сведения об этой системе расширений. Эта информация одинакова для всех примеров и хранится в заголовке содержимого (не в каждом примере). Этот параметр может принимать значение NULL. Чтобы найти необходимый размер буфера, присвойте этому параметру значение NULL; размер возвращается в pcbExtensionSystemInfo.

[in, out] pcbExtensionSystemInfo

На входных данных указывает размер буфера, на который указывает pbExtensionSystemInfo. В выходных данных получает требуемый размер буфера pbExtensionSystemInfo в байтах .

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Недопустимый аргумент.
MF_E_BUFFERTOOSMALL	Буфер, указанный в pbExtensionSystemInfo , слишком мал.
MF_E_INVALIDINDEX	Параметр wPayloadExtensionNumber выходит за пределы диапазона.

Требования

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

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

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount

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