Compartir a través de


Método IAMPluginControl::GetPreferredClsid (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.

Busca en la lista preferida un identificador de clase (CLSID) que coincida con un subtipo especificado.

Sintaxis

HRESULT GetPreferredClsid(
  [in]  REFGUID subType,
  [out] CLSID   *clsid
);

Parámetros

[in] subType

Un GUID de subtipo multimedia que debe coincidir.

[out] clsid

Recibe un CLSID de la lista preferida.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
El método se ha llevado a cabo de forma correcta.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
No se encontró ningún CLSID que coincida con este subtipo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)

Consulte también

IAMPluginControl

Conexión inteligente