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


Метод ICodecAPI::IsSupported (strmif.h)

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

Метод IsSupported запрашивает, поддерживает ли кодек данное свойство.

Синтаксис

HRESULT IsSupported(
  [in] const GUID *Api
);

Параметры

[in] Api

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

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_FALSE
Кодек не поддерживает свойство .
S_OK
Кодек поддерживает свойство .
E_NOTIMPL
Кодек не поддерживает свойство .

Комментарии

Любые ошибки, кроме ошибок, приведенных в предыдущей таблице, указывают на невозможность обработки вызова.

Примечание Если кодек не поддерживает свойство , метод может возвращать либо S_FALSE , либо E_NOTIMPL. Значение E_NOTIMPL является предпочтительным, но в более ранней документации перечислены только S_FALSE, поэтому некоторые кодеки могут возвращать это значение. Приложения должны явно проверять значение S_OK.
 

Требования

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

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

Справочник по API кодека

API кодировщика

ICodecAPI