Metodo ICaptureGraphBuilder2::FindPin (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il FindPin metodo recupera un particolare pin su un filtro o determina se un pin specificato corrisponde ai criteri specificati.

Sintassi

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

Parametri

[in] pSource

Puntatore a un'interfaccia in un filtro o a un'interfaccia su un pin.

[in] pindir

Membro dell'enumerazione PIN_DIRECTION che specifica la direzione del pin (input o output).

[in] pCategory

Puntatore a un GUID che specifica una delle categorie di pin elencate in Pin Property Set. Per trovare la corrispondenza con qualsiasi pin, indipendentemente dalla categoria, impostare questo parametro su NULL.

[in] pType

Puntatore a un GUID di tipo principale che specifica il tipo di supporto. Usare NULL per trovare la corrispondenza con qualsiasi tipo di supporto.

[in] fUnconnected

Valore booleano che specifica se il pin deve essere non connesso. Se TRUE, il pin deve essere non connesso. Se FALSE, il pin può essere connesso o non connesso.

[in] num

Indice in base zero del pin da recuperare, dal set di pin corrispondenti. Se pSource è un puntatore a un filtro e più pin corrispondono ai criteri di ricerca, questo parametro specifica il pin da recuperare. Se pSource è un puntatore a un pin, questo parametro viene ignorato.

[out] ppPin

Indirizzo di un puntatore per ricevere l'interfaccia IPin del pin corrispondente.

Valore restituito

Restituisce S_OK se viene trovato un pin corrispondente o E_FAIL in caso contrario.

Commenti

Se pSource è un puntatore a un filtro, il metodo cerca l'npin su tale filtro che corrisponde ai criteri di ricerca, dove n viene assegnato dal parametro num . Se il metodo trova un pin corrispondente, restituisce un puntatore al pin nel parametro ppPin .

Se pSource è un puntatore a un pin, il metodo verifica il blocco rispetto ai criteri di ricerca. Se il pin corrisponde ai criteri, il metodo restituisce S_OK e restituisce un puntatore all'interfaccia IPin del pin nel parametro ppPin . In caso contrario, restituisce E_FAIL.

In entrambi i casi, se il metodo ha esito positivo, l'interfaccia IPin restituita nel parametro ppPin ha un conteggio dei riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine dell'uso.

In genere, un'applicazione non dovrà usare questo metodo. Viene fornito per attività insolitamente complesse, quando il metodo ICaptureGraphBuilder2::RenderStream non può compilare il grafico del filtro. Usare questo metodo per recuperare un pin desiderato da un filtro di acquisizione e quindi compilare manualmente il resto del grafico.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia ICaptureGraphBuilder2