KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION-Struktur (ksmedia.h)
Die KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION-Struktur fügt eine Pufferbasisadresse, eine angeforderte Puffergröße und eine Benachrichtigungsanzahl an eine KSPROPERTY-Struktur an. Diese Struktur wird vom Client verwendet, um die Zuordnung des Audiopuffers über KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION anzufordern.
Syntax
typedef struct {
KSPROPERTY Property;
PVOID BaseAddress;
ULONG RequestedBufferSize;
ULONG NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;
Member
Property
Eine KSPROPERTY-Struktur, die der Client ordnungsgemäß initialisiert, bevor KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION aufgerufen wird.
BaseAddress
Gibt die Pufferbasisadresse an. Sofern der Client keine Basisadresse angibt, wird dieser Parameter auf NULL festgelegt.
RequestedBufferSize
Gibt die 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.
NotificationCount
Gibt die Anzahl der Benachrichtigungen pro Zyklus des zyklischen Puffers an. Derzeit sind die gültigen Werte 1 oder 2. Der Wert 1 führt zu einer Benachrichtigung an registrierte Benachrichtigungsereignisse am Ende des zyklischen Puffers. Der Wert 2 führt zu Benachrichtigungen sowohl am Mittleren als auch am Ende des zyklischen Puffers.
Hinweise
Die KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION-Anforderung verwendet die KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION-Struktur, um den vom Client angeforderten zyklischen Puffer zu beschreiben. Der Treiber gibt eine KSRTAUDIO_BUFFER-Struktur zurück, um den tatsächlich zugeordneten Puffer zu beschreiben.
Wie bei KSPROPERTY_RTAUDIO_BUFFER ist der Wert, den der Client in den RequestedBufferSize-Member schreibt, nicht für den Treiber gebunden.
Die Verwendung von KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION erleichtert die Ereignissignalisierung, wenn DMA den zyklischen Puffer durchläuft. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT wird verwendet, um Ereignisse zu registrieren, um diese Benachrichtigungen zu erhalten, und KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT wird verwendet, um die Registrierung von Ereignissen aufzuheben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Windows-Betriebssystemen. |
| Kopfzeile | ksmedia.h |
Weitere Informationen
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION