KSRTAUDIO_BUFFER_PROPERTY structure

La structure KSRTAUDIO_BUFFER_PROPERTY ajoute une adresse de base de mémoire tampon et la taille de mémoire tampon demandée à 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.

Syntaxe

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
} KSRTAUDIO_BUFFER_PROPERTY, *PKSRTAUDIO_BUFFER_PROPERTY;

Membres

Propriété
Structure KSPROPERTY que le client initialise de manière appropriée avant d’appeler KSPROPERTY_RTAUDIO_BUFFER.

BaseAddress
Spécifie l’adresse de base de la mémoire tampon souhaitée. Sauf si le client spécifie une adresse de base, ce paramètre est défini sur NULL.

RequestedBufferSize
Spécifie la taille de mémoire tampon souhaitée en octets. Le pilote retourne la taille réelle de la mémoire tampon allouée dans la structure KSRTAUDIO_BUFFER qu’il retourne.

Remarques

La requête KSPROPERTY_RTAUDIO_BUFFER utilise la structure KSRTAUDIO_BUFFER_PROPERTY 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 qui a été réellement allouée.

La valeur que le client écrit dans le membre RequestedBufferSize n’est pas une liaison sur le pilote. Toutefois, le pilote doit spécifier une taille de mémoire tampon aussi proche que possible de la taille demandée, en tenant compte des contraintes de taille de mémoire tampon sur le pilote lui-même. Le pilote alloue une mémoire tampon d’une taille différente si le matériel ne peut pas gérer la taille demandée ou si le système manque de mémoire. Par exemple, un pilote alloue une mémoire tampon inférieure à une page mémoire, ou arrondit la taille de la mémoire tampon au bloc d’exemple suivant. En outre, si le système manque de mémoire, le pilote alloue une mémoire tampon inférieure à la taille demandée.

Spécifications

Version	Disponible dans les systèmes d’exploitation Windows Vista et ultérieurs.
En-tête	Ksmedia.h