HDAUDIO_BUFFER_DESCRIPTOR structure (hdaudio.h)

  • Article

La structure HDAUDIO_BUFFER_DESCRIPTOR spécifie un descripteur de mémoire tampon, qui est une entrée dans une liste de descripteurs de mémoire tampon (BDL).

Syntaxe

typedef struct _HDAUDIO_BUFFER_DESCRIPTOR {
  PHYSICAL_ADDRESS Address;
  ULONG            Length;
  ULONG            InterruptOnCompletion;
} HDAUDIO_BUFFER_DESCRIPTOR, *PHDAUDIO_BUFFER_DESCRIPTOR;

Membres

Address

Spécifie l’adresse de début d’un fragment physiquement contigu de la mémoire tampon. Dans le cas d’une adresse 32 bits, l’adresse doit être justifiée à droite et les 32 bits les plus significatifs (MSB) du membre doivent être zéro.

Length

Spécifie la taille en octets du fragment de mémoire tampon.

InterruptOnCompletion

Spécifie si le moteur DMA doit générer une interruption à la fin du transfert du fragment de mémoire tampon. La valeur 1 active l’interruption. La valeur 0 la désactive.

Remarques

Un BDL est un tableau de structures HDAUDIO_BUFFER_DESCRIPTOR. Chaque structure spécifie un fragment physiquement contigu de la mémoire tampon. Une bibliothèque BDL spécifie tous les fragments qui composent la mémoire tampon.

Le membre Address contient l’adresse de mémoire physique du début du fragment de mémoire tampon. Le membre Length spécifie le nombre d’octets de mémoire physiquement contiguë que contient le fragment.

Si le bit InterruptOnCompletion est défini lors d’un transfert DMA vers ou depuis le fragment de mémoire tampon, le moteur DMA génère une interruption à la fin du transfert.

Cette structure est utilisée par les routines AllocateContiguousDmaBuffer et SetupDmaEngineWithBdl .

Pour plus d’informations sur les bibliothèques DEL, consultez la spécification audio haute définition Intel sur le site web d’Intel HD Audio .

Configuration requise

Condition requise Valeur
En-tête hdaudio.h (inclure Hdaudio.h)

Voir aussi

AllocateContiguousDmaBuffer

SetupDmaEngineWithBdl