KSRTAUDIO_BUFFER_PROPERTY-Struktur

Die KSRTAUDIO_BUFFER_PROPERTY-Struktur fügt eine Pufferbasisadresse und eine angeforderte Puffergröße an eine KSPROPERTY-Struktur an. Diese Struktur wird vom Client verwendet, um die Zuordnung des Audiopuffers über KSPROPERTY_RTAUDIO_BUFFER anzufordern.

Syntax

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

Member

Eigenschaft
Eine KSPROPERTY-Struktur, die der Client ordnungsgemäß initialisiert, bevor KSPROPERTY_RTAUDIO_BUFFER aufgerufen wird.

BaseAddress
Gibt die gewünschte Pufferbasisadresse an. Sofern der Client keine Basisadresse angibt, wird dieser Parameter auf NULL festgelegt.

RequestedBufferSize
Gibt die gewünschte Puffergröße in Bytes an. Der Treiber gibt die tatsächliche Größe des zugeordneten Puffers in der KSRTAUDIO_BUFFER-Struktur zurück, die er zurückgibt.

Hinweise

Die KSPROPERTY_RTAUDIO_BUFFER-Anforderung verwendet die KSRTAUDIO_BUFFER_PROPERTY-Struktur, um den vom Client angeforderten zyklischen Puffer zu beschreiben. Der Treiber gibt eine KSRTAUDIO_BUFFER-Struktur zurück, um den puffer zu beschreiben, der tatsächlich zugeordnet wurde.

Der Wert, den der Client in den RequestedBufferSize-Member schreibt, ist für den Treiber nicht gebunden. Der Treiber muss jedoch eine Puffergröße angeben, die der angeforderten Größe möglichst nahe kommt, wobei die Puffergrößeneinschränkungen für den Treiber selbst berücksichtigt werden. Der Treiber weist einen Puffer einer anderen Größe zu, wenn die Hardware die angeforderte Größe nicht verarbeiten kann oder das System nicht genügend Arbeitsspeicher hat. Beispielsweise ordnet ein Treiber einen Puffer zu, der nicht kleiner als eine Speicherseite ist, oder er rundet die Puffergröße auf den nächsten ganzen Beispielblock ab. Wenn das System nicht genügend Arbeitsspeicher zur Verfügung hat, weist der Treiber einen Puffer zu, der kleiner als die angeforderte Größe ist.

Requirements (Anforderungen)

Version	Verfügbar in Windows Vista und höheren Windows-Betriebssystemen.
Header	Ksmedia.h