struttura KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e nei sistemi operativi Windows successivi. |
| Intestazione | ksmedia.h |
Vedi anche
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION