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