Classe CBaseInputPin

[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 CBaseInputPin classe è una classe base astratta per implementare i pin di input. Questa classe aggiunge il supporto per l'interfaccia IMemInputPin , oltre al supporto dell'interfaccia IPin fornito da CBasePin.

Per usare questa classe, derivare una nuova classe ed eseguire l'override di almeno i metodi seguenti:

• CBaseInputPin::BeginFlush
• CBaseInputPin::EndFlush
• CBaseInputPin::Receive
• CBasePin::CheckMediaType
• CBasePin::GetMediaType

A seconda della funzione del pin, potrebbe essere necessario eseguire l'override di metodi aggiuntivi in CBaseInputPin o CBasePin.

Variabili membro protette	Descrizione
m_pAllocator	Puntatore all'allocatore di memoria.
m_bReadOnly	Flag che indica se l'allocatore produce esempi multimediali di sola lettura.
m_bFlushing	Flag che indica se il pin è attualmente in fase di scaricamento.
m_SampleProps	Proprietà dell'esempio più recente.
Metodi pubblici	Descrizione
CBaseInputPin	Metodo costruttore.
~CBaseInputPin	Metodo distruttore.
BreakConnect	Rilascia il pin da una connessione.
IsReadOnly	Esegue query sul fatto che l'allocatore usi esempi multimediali di sola lettura.
IsFlushing	Esegue una query sul fatto che il filtro sia attualmente in fase di scaricamento.
CheckStreaming	Determina se il pin può accettare esempi. Virtuale.
PassNotify	Passa un messaggio di controllo qualità all'oggetto appropriato.
Inactive	Notifica al pin che il filtro non è più attivo. Virtuale.
SampleProps	Recupera le proprietà dell'esempio più recente.
Metodi IPin	Descrizione
BeginFlush	Avvia un'operazione di scaricamento.
EndFlush	Termina un'operazione di scaricamento.
Metodi IMemInputPin	Descrizione
GetAllocator	Recupera l'allocatore di memoria proposto da questo pin.
NotifyAllocator	Specifica un allocatore per la connessione.
GetAllocatorRequirements	Recupera le proprietà dell'allocatore richieste dal pin di input.
Ricevere	Riceve l'esempio multimediale successivo nel flusso.
ReceiveMultiple	Riceve più esempi nel flusso.
ReceiveCanBlock	Determina se le chiamate al metodo CBaseInputPin::Receive potrebbero bloccare.
Metodi IQualityControl	Descrizione
Notifica	Riceve un messaggio di controllo qualità.

Requisiti

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