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


Метод IMpeg2Demultiplexer::SetOutputPinMediaType (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод SetOutputPinMediaType обновляет тип носителя указанного выходного контакта. (DirectX 9.0 и более поздних версий.)

Синтаксис

HRESULT SetOutputPinMediaType(
  [in] LPWSTR        pszPinName,
  [in] AM_MEDIA_TYPE *pMediaType
);

Параметры

[in] pszPinName

Понятное имя контакта, указанное при создании контакта при вызове CreateOutputPin.

[in] pMediaType

Указатель на структуру AM_MEDIA_TYPE , указывающую сведения о новом типе носителя для закрепления.

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

В случае успешного выполнения возвращает S_OK. Если метод завершается сбоем, он возвращает код ошибки HRESULT .

Комментарии

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

Тип носителя никак не интерпретируется фильтром Demultiplexer. Он используется только во время согласования соединения выходным закреплением. Он не влияет на содержимое примеров мультимедиа. Пример содержимого мультимедиа определяется при сопоставлении PID с помощью параметра MEDIA_SAMPLE_CONTENT в методе IMPEG2PIDMap::MapPID или с помощью определенных значений в вызове IMPEG2StreamIdMap::MapStreamId .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Коды ошибок и успешного выполнения

Интерфейс IMpeg2Demultiplexer