Funzione CreatePosPassThru

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

La CreatePosPassThru funzione crea un oggetto CPosPassThru o un oggetto CRendererPosPassThru .

Sintassi

STDAPI CreatePosPassThru(
   LPUNKNOWN pAgg,
   BOOL      bRenderer,
   IPin      *pPin,
   IUnknown  **ppPassThru
);

Parametri

pAgg

Puntatore al proprietario di questo oggetto. Se l'oggetto viene aggregato, passare un puntatore all'interfaccia IUnknown dell'oggetto di aggregazione. In caso contrario, impostare questo parametro su NULL.

bRenderer

Valore booleano che specifica se il filtro è un renderer. Usare il valore TRUE se il filtro è un renderer o FALSE in caso contrario. Se il valore è TRUE, questo metodo crea un'istanza della classe CRendererPosPassThru . Se il valore è FALSE, il metodo crea un'istanza della classe CPosPassThru .

pPin

Puntatore all'interfaccia IPin nel pin di input del filtro.

ppPassThru

Indirizzo di una variabile che riceve un puntatore all'interfaccia IUnknown dell'oggetto.

Valore restituito

Restituisce S_OK se riuscito. In caso contrario, restituisce un valore HRESULT che indica la causa dell'errore.

Commenti

Questo metodo usa l'interfaccia ISeekingPassThru per creare l'oggetto. L'oggetto viene caricato dinamicamente da Quartz.dll.

Se la funzione ha esito positivo, l'interfaccia IUnknown restituita ha un numero di riferimenti in sospeso. Il chiamante deve rilasciare l'interfaccia.

Requisiti

Requisito	Valore
Intestazione	Ctlutil.h (includere Streams.h)
Libreria	Strmbase.lib (build al dettaglio); Strmbasd.lib (build di debug)

Vedi anche

Classe CPosPassThru