Compartilhar via

Método IAMGraphStreams::FindUpstreamInterface (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O FindUpstreamInterface método pesquisa no grafo de filtro uma interface especificada, upstream de um pin especificado.

Sintaxe

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

Parâmetros

[in] pPin

Ponteiro para a interface IPin de um pino. O pino deve pertencer a um filtro no grafo de filtro.

[in] riid

Referência a um IID (identificador de interface) que especifica a interface a ser encontrada.

[out] ppvInterface

Endereço de um ponteiro nulo. Se o método for bem-sucedido, essa variável receberá um ponteiro para a interface especificada por riid.

[in] dwFlags

Combinação de sinalizadores da enumeração AM_INTF_SEARCH_FLAGS , especificando o que pesquisar (pinos ou filtros).

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
E_NOINTERFACE
 Interface não encontrada.
E_POINTER
 Ponteiro inválido.
S_OK
 Êxito.

Comentários

Se dwFlags for zero, esse método pesquisa a interface na seguinte ordem:

  1. Ele consulta o pino especificado por pPin.
  2. Se pPin for um pino de entrada, ele chamará FindUpstreamInterface recursivamente no pino de saída que está conectado ao pPin, se houver.

    Se pPin for um pino de saída, ele consultará o filtro que possui pPin. Em seguida, ele cria uma lista de pinos de entrada no filtro que têm conexões internas com pPin e chama FindUpstreamInterface recursivamente nesses pinos de entrada.

    Para criar uma lista de pinos de entrada com conexões internas, o método faz o seguinte:

Ele para no primeiro objeto encontrado que dá suporte à interface . Você pode limitar os objetos pesquisados (filtros, pinos de entrada ou pinos de saída) definindo dwFlags como um valor diferente de zero.
Nota O método ICaptureGraphBuilder2::FindInterface implementa uma abordagem mais geral para esse problema e, na maioria das situações, é preferível.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IAMGraphStreams Interface