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

Метод IMFDeviceTransform::GetInputStreamPreferredState (mftransform.h)

  • Статья

Метод GetInputStreamPreferredState получает предпочитаемое состояние и тип мультимедиа входного потока MFT устройства.

Синтаксис

HRESULT GetInputStreamPreferredState(
  [in]  DWORD             dwStreamID,
  [out] DeviceStreamState *value,
  [out] IMFMediaType      **ppMediaType
);

Параметры

[in] dwStreamID

Идентификатор потока входного потока, состояние которого необходимо получить.

[out] value

Указывает текущий параметр DeviceStreamState указанного входного потока MFT устройства.

[out] ppMediaType

Предпочтительный тип мультимедиа для входного потока передается через этот параметр.

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

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

Код возврата Описание
S_OK
 Передача состояния потока выполнена успешно.
MF_E_INVALIDREQUEST
 В настоящее время устройство MFT не поддерживает запрос.
MF_E_INVAILIDSTREAMNUMBER
 Передан недопустимый идентификатор потока.
MF_E_INVALID_STREAM_STATE
 Запрошенный переход потока невозможен.

Комментарии

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

Если для изменения типа мультимедиа выходного потока требуется соответствующее изменение входных данных, устройство MFT будет отправлять METransformInputStreamStateChanged в DTM, чтобы изменить соответствующий входной поток. DTM вызывает GetInputStreamPreferredState , чтобы получить предпочтительный тип и состояние входного потока MFT устройства.

В качестве примера рассмотрим MFT-устройство с двумя входными и тремя потоками вывода. Оставьте выходные данные 1 и выходные данные 2 из входных данных 1 и потоковую передачу с 720p. Теперь предположим, что тип носителя выходных данных 2 изменится на 1080p. Чтобы удовлетворить этот запрос, MFT устройства необходимо изменить тип носителя Input 1 на 1080p, опубликовав событие METransformInputStreamStateChanged в DTM. DTM вызовет Метод GetInputStreamPreferredState и извлекает предпочтительное состояние и тип мультимедиа. DTM вызывает SetInputStreamState , чтобы изменить тип и состояние медиатипа входного потока.

Требования

   
Минимальная версия клиента Windows 10 версии 1703
Целевая платформа Windows
Header mftransform.h

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

IMFDeviceTransform