Metodo CBasePin.QueryInternalConnections

  • Articolo

[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 QueryInternalConnections metodo recupera i pin connessi internamente a questo pin (all'interno del filtro). Questo metodo implementa il metodo IPin::QueryInternalConnections .

Sintassi

HRESULT QueryInternalConnections(
   IPin  *apPin,
   ULONG *nPin
);

Parametri

Appin

Indirizzo di una matrice di puntatori IPin .

nPin

In input, specifica le dimensioni della matrice. Quando termina, il valore viene impostato sul numero di puntatori restituiti nella matrice.

Valore restituito

Restituisce uno dei valori HRESULT illustrati nella tabella seguente.

Codice restituito Descrizione
S_FALSE
 Dimensioni della matrice insufficienti.
S_OK
 Operazione completata.
E_FAIL
 Esito negativo.
E_NOTIMPL
 Non implementato.

Commenti

In alcuni filtri, i pin di input corrispondono a specifici pin di output. Per ogni pin, questo metodo riempie una matrice con puntatori ai pin corrispondenti. Se ogni pin di input fornisce dati per ogni pin di output, restituire E_NOTIMPL.

Requisiti

Requisito Valore
Intestazione
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePin