Share via

Метод IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

  • Статья

Возвращает формат, который изначально поддерживается источником мультимедиа.

Синтаксис

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Параметры

[in] dwStreamIndex

Указывает, к какому потоку будет выполняться запрос. Значением может быть любое из следующих значений.

Значение Значение
0–0xFFFFFFFB
 Отсчитываемый от нуля индекс потока.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 Первый видеопоток.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 Первый аудиопоток.

[in] dwMediaTypeIndex

Указывает тип носителя для запроса. Значением может быть любое из следующих значений.

Значение Значение
0–0xFFFFFFFE
 Отсчитываемый от нуля индекс типа мультимедиа
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
 Текущий собственный тип мультимедиа.

[out] ppMediaType

Получает указатель на интерфейс IMFMediaType . Вызывающий объект должен освободить интерфейс .

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый параметр dwStreamIndex .
MF_E_NO_MORE_TYPES
 Параметр dwMediaTypeIndex выходит за пределы диапазона.

Комментарии

Этот метод запрашивает у базового источника мультимедиа собственный выходной формат. Потенциально каждый исходный поток может создавать несколько выходных форматов. Используйте параметр dwMediaTypeIndex для циклического просмотра доступных форматов. Как правило, источники файлов предлагают только один формат для каждого потока, но устройства записи могут предлагать несколько форматов.

Метод возвращает копию типа носителя, поэтому можно с уверенностью изменять объект, полученный в параметре ppMediaType .

Чтобы задать тип вывода для потока, вызовите метод IMFSourceReader::SetCurrentMediaType .

Этот интерфейс доступен в Windows Vista, если установлено дополнение к обновлению платформы для Windows Vista.

Требования

Требование Значение
Минимальная версия клиента Дополнение к Windows 7, Windows Vista и обновлению платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfreadwrite.h

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

IMFSourceReader

Средство чтения исходного кода