Interfaccia IAMBufferNegotiation (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.

L'interfaccia IAMBufferNegotiation richiede il numero di buffer per un filtro per creare e ridimensionare ogni buffer. Questa interfaccia può essere esposta da qualsiasi pin che si connette usando l'interfaccia pin IMemInputPin , ma viene in genere esposta sui pin di output dei filtri di acquisizione.

Quando due pin si connettono tramite IMemInputPin, accettano un oggetto allocatore responsabile della creazione di buffer. In genere questo processo è trasparente per l'applicazione, ma in alcune situazioni l'applicazione richiede un maggiore controllo. Se un pin espone IAMBufferNegotiation, l'applicazione può suggerire il numero di buffer da creare, le dimensioni dei buffer e altre proprietà. Se l'applicazione esegue l'anteprima dell'audio acquisito, è possibile specificare una dimensione del buffer inferiore per ridurre la latenza. Le applicazioni di teleconferenza devono specificare un numero minimo di buffer.

Per usare questa interfaccia, chiamare il metodo SuggestAllocatorProperties prima della connessione dei pin. Dopo la connessione dei pin, chiamare il metodo GetAllocatorProperties per determinare se il pin ha rispettato la richiesta.

Filtrare gli sviluppatori: i filtri di acquisizione devono sempre supportare questa interfaccia quando possibile.

Ereditarietà

L'interfaccia IAMBufferNegotiation eredita dall'interfaccia IUnknown . IAMBufferNegotiation ha anche questi tipi di membri:

Metodi

L'interfaccia IAMBufferNegotiation dispone di questi metodi.

IAMBufferNegotiation::GetAllocatorProperties Il metodo GetAllocatorProperties recupera le proprietà dell'allocatore in uso dal pin.
Proprietà IAMBufferNegotiation::SuggestAllocator Il metodo SuggestAllocatorProperties indica il pin delle proprietà dell'allocatore preferite dell'applicazione. Chiamare questo metodo prima della connessione del pin.

Requisiti

Requisito	Valore
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)

Vedi anche

Interfacce