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 la notification aux événements de notification enregistrés à la fin de la mémoire tampon cyclique. La valeur 2 entraîne 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 l'RequestedBufferSize membre n’est pas liée au pilote.
L’utilisation de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION facilite la signalisation des événements au fur et à mesure que la DMA progresse dans la mémoire tampon cyclique. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT est utilisé pour inscrire des événements pour recevoir ces notifications et KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT est utilisé pour annuler l’inscription des événements.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible dans Windows Vista et les systèmes d’exploitation Windows ultérieurs. |
d’en-tête | ksmedia.h |
Voir aussi
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION