estructura HDAUDIO_BUFFER_DESCRIPTOR (hdaudio.h)

Artículo
03/05/2024

La estructura HDAUDIO_BUFFER_DESCRIPTOR especifica un descriptor de búfer, que es una entrada de una lista de descriptores de búfer (BDL).

Sintaxis

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

Miembros

Address

Especifica la dirección inicial de un fragmento físico contiguo del búfer. En el caso de una dirección de 32 bits, la dirección debe estar justificada a la derecha y los 32 bits más significativos (MSB) del miembro deben ser cero.

Length

Especifica el tamaño en bytes del fragmento de búfer.

InterruptOnCompletion

Especifica si el motor DMA debe generar una interrupción al completar la transferencia del fragmento de búfer. Un valor de 1 habilita la interrupción. Un valor de 0 lo deshabilita.

Comentarios

Un BDL es una matriz de estructuras de HDAUDIO_BUFFER_DESCRIPTOR. Cada estructura especifica un fragmento físico contiguo del búfer. Un BDL especifica todos los fragmentos que componen el búfer.

El miembro Address contiene la dirección de memoria física del inicio del fragmento de búfer. El miembro Length especifica el número de bytes de memoria físicamente contigua que contiene el fragmento.

Si el bit InterruptOnCompletion se establece durante una transferencia DMA a o desde el fragmento de búfer, el motor DMA genera una interrupción al finalizar la transferencia.

Esta estructura la usan las rutinas AllocateContiguousDmaBuffer y SetupDmaEngineWithBdl .

Para obtener más información sobre las BDL, consulte especificación de audio de alta definición de Intel en el sitio web de Intel HD Audio .