struttura KSRTAUDIO_BUFFER_PROPERTY

La struttura KSRTAUDIO_BUFFER_PROPERTY aggiunge un indirizzo di base del buffer e le dimensioni del buffer richieste a una struttura KSPROPERTY . Questa struttura viene usata dal client per richiedere l'allocazione del buffer audio tramite KSPROPERTY_RTAUDIO_BUFFER.

Sintassi

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
} KSRTAUDIO_BUFFER_PROPERTY, *PKSRTAUDIO_BUFFER_PROPERTY;

Members

Proprietà
Struttura KSPROPERTY che il client inizializza in modo appropriato prima di chiamare KSPROPERTY_RTAUDIO_BUFFER.

Baseaddress
Specifica l'indirizzo di base del buffer desiderato. A meno che il client non specifichi un indirizzo di base, questo parametro è impostato su NULL.

RequestedBufferSize
Specifica le dimensioni del buffer desiderate in byte. Il driver restituisce le dimensioni effettive del buffer allocato nella struttura KSRTAUDIO_BUFFER restituita.

Commenti

La richiesta di KSPROPERTY_RTAUDIO_BUFFER usa la struttura KSRTAUDIO_BUFFER_PROPERTY per descrivere il buffer ciclico richiesto dal client. Il driver restituisce una struttura KSRTAUDIO_BUFFER per descrivere il buffer effettivamente allocato.

Il valore scritto dal client nel membro RequestedBufferSize non è a livello di binding nel driver. Tuttavia, il driver deve specificare una dimensione del buffer il più vicina possibile alla dimensione richiesta, tenendo conto dei vincoli di dimensione del buffer sul driver stesso. Il driver alloca un buffer di dimensioni diverse se l'hardware non è in grado di gestire le dimensioni richieste o se la memoria del sistema è insufficiente. Ad esempio, un driver alloca un buffer non inferiore a una pagina di memoria o arrotonda le dimensioni del buffer fino all'intero blocco di esempio successivo. Inoltre, se il sistema è in esecuzione insufficiente in memoria, il driver alloca un buffer inferiore alle dimensioni richieste.

Requisiti

Versione	Disponibile in Windows Vista e nei sistemi operativi Windows successivi.
Intestazione	Ksmedia.h