HDAUDIO_BUFFER_DESCRIPTOR struttura (hdaudio.h)

Articolo
02/26/2024

La struttura HDAUDIO_BUFFER_DESCRIPTOR specifica un descrittore del buffer, ovvero una voce in un elenco di descrittori buffer (BDL).

Sintassi

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

Members

Address

Specifica l'indirizzo iniziale di un frammento fisicamente contiguo del buffer. Nel caso di un indirizzo a 32 bit, l'indirizzo deve essere giustificato correttamente e i 32 bit più significativi del membro devono essere zero.

Length

Specifica le dimensioni in byte del frammento di buffer.

InterruptOnCompletion

Specifica se il motore DMA deve generare un interruzione per completare il trasferimento del frammento di buffer. Un valore pari a 1 abilita l'interruzione. Un valore pari a 0 lo disabilita.

Commenti

BDL è una matrice di strutture HDAUDIO_BUFFER_DESCRIPTOR. Ogni struttura specifica un frammento fisicamente contiguo del buffer. Un BDL specifica tutti i frammenti che costituiscono il buffer.

Il membro Address contiene l'indirizzo di memoria fisica dell'inizio del frammento di buffer. Il membro Length specifica il numero di byte di memoria fisicamente contigua che il frammento contiene.

Se il bit InterruptOnCompletion viene impostato durante un trasferimento DMA verso o dal frammento di buffer, il motore DMA genera un interruzione al completamento del trasferimento.

Questa struttura viene usata dalle routine AllocateContiguousDmaBuffer e SetupDmaEngineWithBdl .

Per altre informazioni sui BDLs, vedere la specifica audio Intel High Definition nel sito Web Intel HD Audio .