Partager via


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

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT