structure KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)
La structure KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION ajoute une adresse de base de mémoire tampon, une taille de mémoire tampon demandée et un nombre de notifications à une structure KSPROPERTY . Cette structure est utilisée par le client pour demander l’allocation de la mémoire tampon audio via KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
Syntaxe
typedef struct {
KSPROPERTY Property;
PVOID BaseAddress;
ULONG RequestedBufferSize;
ULONG NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;
Membres
Property
Structure KSPROPERTY que le client initialise correctement avant d’appeler KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
BaseAddress
Spécifie l’adresse de base de la mémoire tampon. Sauf si le client spécifie une adresse de base, ce paramètre est défini sur NULL.
RequestedBufferSize
Spécifie la taille de la mémoire tampon en octets. Le pilote retourne la taille réelle de la mémoire tampon allouée dans la structure KSRTAUDIO_BUFFER qu’il retourne.
NotificationCount
Spécifie le nombre de notifications par cycle de la mémoire tampon cyclique. Actuellement, les valeurs valides sont 1 ou 2. La valeur 1 entraîne une notification aux événements de notification inscrits à la fin de la mémoire tampon cyclique. La valeur 2 génère des notifications à la fois au milieu et à la fin de la mémoire tampon cyclique.
Remarques
La requête KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION utilise la structure KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION pour décrire la mémoire tampon cyclique demandée par le client. Le pilote retourne une structure KSRTAUDIO_BUFFER pour décrire la mémoire tampon réellement allouée.
Comme avec KSPROPERTY_RTAUDIO_BUFFER, la valeur que le client écrit dans le membre RequestedBufferSize n’est pas liée au pilote.
L’utilisation de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilite la signalisation d’événements à mesure que DMA progresse dans la mémoire tampon cyclique. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT est utilisé pour inscrire des événements afin de recevoir ces notifications et KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT est utilisé pour annuler l’inscription des événements.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans les systèmes d’exploitation Windows Vista et ultérieurs. |
| En-tête | ksmedia.h |
Voir aussi
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION