struttura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)

Articolo
03/05/2024

La struttura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION aggiunge un indirizzo di base del buffer, una dimensione del buffer richiesta e un conteggio delle notifiche a una struttura KSPROPERTY . Questa struttura viene usata dal client per richiedere l'allocazione del buffer audio tramite KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

Sintassi

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
  ULONG      NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;

Members

Property

Struttura KSPROPERTY che il client inizializza in modo appropriato prima di chiamare KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

BaseAddress

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

RequestedBufferSize

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

NotificationCount

Specifica il numero di notifiche per ciclo del buffer ciclico. Attualmente, i valori validi sono 1 o 2. Il valore 1 restituisce una notifica agli eventi di notifica registrati alla fine del buffer ciclico. Il valore 2 restituisce notifiche sia a metà che alla fine del buffer ciclico.

Commenti

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

Come per KSPROPERTY_RTAUDIO_BUFFER, il valore scritto dal client nel membro RequestedBufferSize non è associato al driver.

L'uso di KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilita la segnalazione degli eventi man mano che DMA progredisce attraverso il buffer ciclico. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT viene usato per registrare gli eventi per ricevere queste notifiche e KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT viene usato per annullare la registrazione degli eventi.