Metodo ICaptureGraphBuilder::FindInterface (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia ICaptureGraphBuilder è deprecata. Usare invece ICaptureGraphBuilder2 .

Cerca l'interfaccia specificata sul filtro, sustream e downstream dal filtro e, facoltativamente, solo sul pin di output della categoria specificata.

Sintassi

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

Parametri

[in] pCategory

Puntatore a un GUID che specifica la categoria di pin di output. Vedere Pin Property Set per un elenco di tutte le categorie di pin. NULL indica la ricerca di tutti i pin di output indipendentemente dalla categoria.

[in] pf

Puntatore all'interfaccia IBaseFilter del filtro.

[in] riid

ID di riferimento dell'interfaccia desiderata.

[out] ppint

Indirizzo di un puntatore void. Se l'interfaccia è stata trovata, questo metodo inizializza ppint in modo che contenga l'indirizzo di un puntatore all'interfaccia trovata. Chiamare il metodo Release per decrerere il conteggio dei riferimenti al termine dell'interfaccia.

Valore restituito

Restituisce un valore HRESULT .

Commenti

Questo metodo cerca l'interfaccia del filtro e l'upstream del filtro, a meno che non venga specificata una categoria. Se viene specificata una categoria, sembra solo downstream del pin di output di tale categoria. Può essere usato per trovare interfacce su renderer, multiplexer, tuner TV, barre incrociate e così via.

Se pCategory è uguale a &LOOK_UPSTREAM_ONLY, il generatore di grafici cercherà a monte del filtro specificato nel parametro pf, ma non nel filtro stesso, né a valle del filtro.

Se pCategory è uguale a &LOOK_DOWNSTREAM_ONLY, il generatore di grafici cercherà downstream del filtro specificato nel parametro pf, ma non nel filtro stesso, né a monte del filtro.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici errore e esito positivo

Interfaccia ICaptureGraphBuilder

Condividi tramite