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 di 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;
Membri
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 genera una notifica agli eventi di notifica registrati alla fine del buffer ciclico. Un valore pari a 2 genera notifiche sia a metà punto che alla fine del buffer ciclico.
Osservazioni
La richiesta 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 che il client scrive nel membro RequestedBufferSize non è associato al driver.
L'uso di KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilita la segnalazione degli eventi man mano che DMA avanza 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e nei sistemi operativi Windows successivi. |
| intestazione | ksmedia.h |
Vedere anche
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION