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

Метод IMFSinkWriter::SetInputMediaType (mfreadwrite.h)

  • Статья

Задает формат входных данных для потока в записи приемника.

Синтаксис

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Параметры

[in] dwStreamIndex

Отсчитываемый от нуля индекс потока. Индекс получается параметром pdwStreamIndex метода IMFSinkWriter::AddStream .

[in] pInputMediaType

Указатель на интерфейс IMFMediaType типа мультимедиа. Тип носителя определяет формат входных данных.

[in] pEncodingParameters

Указатель на интерфейс IMFAttributes хранилища атрибутов. Используйте хранилище атрибутов для настройки кодировщика. Этот параметр может принимать значение NULL.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_INVALIDMEDIATYPE
 Базовый приемник мультимедиа не поддерживает формат, преобразование невозможно или динамическое изменение формата невозможно.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый параметр dwStreamIndex .
MF_E_TOPO_CODEC_NOT_FOUND
 Не удалось найти кодировщик для закодированного формата.

Комментарии

Формат входных данных не обязательно должен соответствовать целевому формату, который записывается в приемник мультимедиа. Если форматы не совпадают, метод пытается загрузить кодировщик, который может кодировать входной формат в целевой формат.

После начала потоковой передачи, то есть после первого вызова IMFSinkWriter::WriteSample, вы можете в любое время вызвать этот метод, чтобы изменить формат входных данных. Однако базовый кодировщик и приемник мультимедиа должны поддерживать динамические изменения формата.

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

Требования

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

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

IMFSinkWriter

Модуль записи приемника