struttura HDAUDIO_BUFFER_DESCRIPTOR (hdaudio.h)
La struttura HDAUDIO_BUFFER_DESCRIPTOR specifica un descrittore di buffer, ovvero una voce in un elenco di descrittori di buffer (BDL).
Sintassi
typedef struct _HDAUDIO_BUFFER_DESCRIPTOR {
PHYSICAL_ADDRESS Address;
ULONG Length;
ULONG InterruptOnCompletion;
} HDAUDIO_BUFFER_DESCRIPTOR, *PHDAUDIO_BUFFER_DESCRIPTOR;
Membri
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 a destra 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 interrupt al completamento del trasferimento del frammento di buffer. Il valore 1 abilita l'interrupt. Il valore 0 lo disabilita.
Osservazioni
Un file BDL è una matrice di strutture HDAUDIO_BUFFER_DESCRIPTOR. Ogni struttura specifica un frammento fisicamente contiguo del buffer. Un file 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 Lunghezza specifica il numero di byte di memoria fisicamente contigua contenuta nel frammento.
Se l'InterruptOnCompletion bit viene impostato durante un trasferimento DMA da o verso il frammento di buffer, il motore DMA genera un interrupt al completamento del trasferimento.
Questa struttura viene utilizzata dalla AllocateContiguousDmaBuffer e routine SetupDmaEngineWithBdl.
Per altre informazioni sui BDL, vedere la specifica audio Intel High Definition nel sito Web Intel HD Audio.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | hdaudio.h (include Hdaudio.h) |