structure KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION (ksmedia.h)

  • Article

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

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT