Costruttore CBasePin.CBasePin

Articolo
07/28/2023

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

Metodo costruttore.

Sintassi

CBasePin(
   TCHAR         *pObjectName,
   CBaseFilter   *pFilter,
   CCritSec      *pLock,
   HRESULT       *phr,
   LPCWSTR       pName,
   PIN_DIRECTION dir
);

Parametri

pObjectName: Stringa contenente il nome di debug per l'oggetto. Per altre informazioni, vedere CBaseObject.
pFilter: Puntatore al filtro che ha creato questo pin.
Plock: Puntatore a un blocco CCritSec usato per serializzare le modifiche dello stato. Può essere la stessa sezione critica del blocco filtro, CBaseFilter::m_pLock.
Phr: Puntatore a una variabile che riceve un valore HRESULT che indica l'esito positivo o negativo del metodo. Inizializzare il valore da S_OK prima di creare l'oggetto. Il valore viene modificato solo se si verifica un errore.
Pname: Stringa di caratteri wide contenente il nome del pin. Per altre informazioni, vedere CBasePin::QueryPinInfo.
dir: Membro dell'enumerazione PIN_DIRECTION che specifica la direzione del pin.

Commenti

La sezione critica specificata da pLock serializza lo stato del pin, incluso lo stato di connessione, la scelta dell'allocatore, il tipo di supporto e lo stato delle operazioni di scaricamento. Non usare questa sezione critica per serializzare le operazioni di streaming. Per altre informazioni, vedere Flusso di dati in Filter Graph.

Un filtro potrebbe creare pin nel relativo metodo del costruttore, quindi a questo punto il puntatore pFilter potrebbe non fare riferimento a un oggetto valido. Archiviare il puntatore, ma non rinviarlo mentre si trova all'interno del costruttore del pin.

Requisiti

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

Vedi anche

Classe CBasePin

Condividi tramite