Método ICodecAPI::IsSupported (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método IsSupported consulta si un códec admite una propiedad determinada.

Sintaxis

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

Parámetros

[in] Api

Puntero a un GUID que especifica la propiedad que se va a consultar. Para obtener una lista de las propiedades de códec estándar, consulte Propiedades de la API de códec.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_FALSE	El códec no admite la propiedad .
S_OK	El códec admite la propiedad .
E_NOTIMPL	El códec no admite la propiedad .

Observaciones

Cualquier error además de los de la tabla anterior indica la incapacidad de procesar la llamada.

Nota Si el códec no admite la propiedad , el método puede devolver S_FALSE o E_NOTIMPL. Se prefiere el valor E_NOTIMPL , pero la documentación anterior solo se muestra S_FALSE, por lo que algunos códecs pueden devolver ese valor. Las aplicaciones deben probar explícitamente el valor S_OK.

 

Requisitos

Cliente mínimo compatible	Windows XP con SP2 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Referencia de la API de códec

API de codificador

ICodecAPI