Compartir a través de

Método ICaptureGraphBuilder::FindInterface (strmif.h)

  • Artículo

[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.

Nota La interfaz ICaptureGraphBuilder está en desuso. Use ICaptureGraphBuilder2 en su lugar.
 
Busca la interfaz especificada en el filtro, ascendente y descendente del filtro y, opcionalmente, solo en el pin de salida de la categoría especificada.

Sintaxis

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

Parámetros

[in] pCategory

Puntero a un GUID que especifica la categoría de patillas de salida. Vea Anclar conjunto de propiedades para obtener una lista de todas las categorías de patillas. NULL indica buscar todos los patillas de salida independientemente de la categoría.

[in] pf

Puntero a la interfaz IBaseFilter del filtro.

[in] riid

Identificador de referencia de la interfaz deseada.

[out] ppint

Dirección de un puntero void. Si se encontró la interfaz, este método inicializa ppint para que contenga la dirección de un puntero a la interfaz encontrada. Llame al método Release para disminuir el recuento de referencias cuando haya terminado con la interfaz .

Valor devuelto

Devuelve un valor HRESULT .

Comentarios

Este método busca la interfaz en el filtro, y ascendente y descendente del filtro, a menos que se especifique una categoría. Si se proporciona una categoría, solo se ve de bajada del pin de salida de esa categoría. Se puede usar para buscar interfaces en representadores, multiplexores, tuners de TV, barras cruzadas, etc.

Si pCategory es igual a &LOOK_UPSTREAM_ONLY, el generador de grafos tendrá un aspecto ascendente del filtro especificado en el parámetro pf, pero no en el propio filtro, ni en la bajada del filtro.

Si pCategory es igual a &LOOK_DOWNSTREAM_ONLY, el generador de grafos tendrá un aspecto inferior del filtro especificado en el parámetro pf, pero no en el propio filtro, ni en la parte superior del filtro.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)

Consulte también

Códigos de error y éxito

ICaptureGraphBuilder (interfaz)