Метод IMFMediaTypeHandler::IsMediaTypeSupported (mfidl.h)

Статья
08/24/2023

Запрашивает, поддерживает ли объект указанный тип мультимедиа.

Синтаксис

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

Параметры

[in] pMediaType

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

[out] ppMediaType

Получает указатель на интерфейс IMFMediaType ближайшего соответствующего типа носителя или получает значение NULL. Если значение не равно NULL, вызывающий объект должен освободить интерфейс. Этот параметр может принимать значение NULL. См. заметки.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
MF_E_INVALIDMEDIATYPE	Объект не поддерживает этот тип мультимедиа.

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

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

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Требования

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

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

IMFMediaTypeHandler

Share via