Compartir a través de

Método IAMGraphStreams::FindUpstreamInterface (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.

El FindUpstreamInterface método busca en el gráfico de filtros una interfaz especificada, ascendente desde un pin especificado.

Sintaxis

HRESULT FindUpstreamInterface(
  [in]  IPin   *pPin,
  [in]  REFIID riid,
  [out] void   **ppvInterface,
  [in]  DWORD  dwFlags
);

Parámetros

[in] pPin

Puntero a la interfaz IPin de un pin. El pin debe pertenecer a un filtro en el gráfico de filtros.

[in] riid

Referencia a un identificador de interfaz (IID) que especifica la interfaz que se va a buscar.

[out] ppvInterface

Dirección de un puntero void. Si el método se realiza correctamente, esta variable recibe un puntero a la interfaz especificada por riid.

[in] dwFlags

Combinación de marcas de la enumeración AM_INTF_SEARCH_FLAGS , especificando qué buscar (patillas o filtros).

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto Descripción
E_NOINTERFACE
 No se encontró la interfaz.
E_POINTER
 Puntero no válido.
S_OK
 Correcto.

Comentarios

Si dwFlags es cero, este método busca la interfaz en el orden siguiente:

  1. Consulta el pin especificado por pPin.
  2. Si pPin es un pin de entrada, llama a FindUpstreamInterface de forma recursiva en el pin de salida que está conectado a pPin, si existe.

    Si pPin es un pin de salida, consulta el filtro que posee pPin. A continuación, crea una lista de patillas de entrada en el filtro que tienen conexiones internas a pPin y llama FindUpstreamInterface a de forma recursiva en esas patillas de entrada.

    Para crear una lista de patillas de entrada con conexiones internas, el método hace lo siguiente:

Se detiene en el primer objeto que encuentra que admite la interfaz . Puede limitar los objetos que se buscan (filtros, patillas de entrada o patillas de salida) estableciendo dwFlags en un valor distinto de cero.
Nota El método ICaptureGraphBuilder2::FindInterface implementa un enfoque más general para este problema y, en la mayoría de las situaciones, se prefiere.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IAMGraphStreams (interfaz)