Compartir a través de


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

Obtiene un identificador de clase (CLSID) de la lista preferida, especificada por el valor de índice.

Sintaxis

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD index,
  [out] GUID  *subType,
  [out] CLSID *clsid
);

Parámetros

[in] index

Índice de base cero del CLSID que se va a recuperar.

[out] subType

Recibe el GUID de subtipo asociado al CLSID.

[out] clsid

Recibe el CLSID en el índice especificado.

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_NO_MORE_ITEMS)
El parámetro de índice está fuera del intervalo.

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