Compartilhar via


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

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

Nota A interface ICaptureGraphBuilder foi preterida. Em vez disso, use ICaptureGraphBuilder2 .
 
Procura a interface especificada no filtro, upstream e downstream do filtro e, opcionalmente, apenas no pino de saída da categoria fornecida.

Sintaxe

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

Parâmetros

[in] pCategory

Ponteiro para um GUID que especifica a categoria de pino de saída. Consulte Fixar Conjunto de Propriedades para obter uma lista de todas as categorias de pino. NULL indica a pesquisa de todos os pinos de saída, independentemente da categoria.

[in] pf

Ponteiro para a interface IBaseFilter do filtro.

[in] riid

ID de referência da interface desejada.

[out] ppint

Endereço de um ponteiro nulo. Se a interface foi encontrada, esse método inicializa ppint para que ela contenha o endereço de um ponteiro para a interface encontrada. Chame o método Release para diminuir a contagem de referência quando terminar de usar a interface .

Retornar valor

Retorna um valor HRESULT .

Comentários

Esse método procura a interface no filtro e upstream e downstream do filtro, a menos que uma categoria seja fornecida. Se uma categoria for fornecida, ela só procurará downstream do pino de saída dessa categoria. Ele pode ser usado para localizar interfaces em renderizadores, multiplexadores, sintonizadores de TV, barras cruzadas e assim por diante.

Se pCategory for igual a &LOOK_UPSTREAM_ONLY, o construtor de grafo procurará upstream do filtro fornecido no parâmetro pf, mas não no próprio filtro, nem downstream do filtro.

Se pCategory for igual a &LOOK_DOWNSTREAM_ONLY, o construtor de grafo procurará downstream do filtro fornecido no parâmetro pf, mas não no próprio filtro, nem upstream do filtro.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Códigos de erro e êxito

ICaptureGraphBuilder Interface