Freigeben über


HDAUDIO_BUFFER_DESCRIPTOR-Struktur (hdaudio.h)

Die HDAUDIO_BUFFER_DESCRIPTOR-Struktur gibt einen Pufferdeskriptor an, bei dem es sich um einen Eintrag in einer Pufferdeskriptorliste (BDL) handelt.

Syntax

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

Member

Address

Gibt die Startadresse eines physisch zusammenhängenden Fragments des Puffers an. Im Fall einer 32-Bit-Adresse sollte die Adresse richtig begründet sein, und die 32 wichtigsten Bits (MSBs) des Members sollten null sein.

Length

Gibt die Größe des Pufferfragments in Bytes an.

InterruptOnCompletion

Gibt an, ob die DMA-Engine beim Abschluss der Übertragung des Pufferfragments einen Interrupt generieren soll. Der Wert 1 aktiviert den Interrupt. Der Wert 0 deaktiviert sie.

Hinweise

Eine BDL ist ein Array von HDAUDIO_BUFFER_DESCRIPTOR Strukturen. Jede Struktur gibt ein physisch zusammenhängendes Fragment des Puffers an. Eine BDL gibt alle Fragmente an, aus denen der Puffer besteht.

Das Address-Element enthält die adresse des physischen Speichers des Anfangs des Pufferfragments. Der Length-Member gibt die Anzahl der Bytes des physisch zusammenhängenden Arbeitsspeichers an, den das Fragment enthält.

Wenn das InterruptOnCompletion-Bit während einer DMA-Übertragung in oder aus dem Pufferfragment festgelegt wird, generiert die DMA-Engine nach Abschluss der Übertragung einen Interrupt.

Diese Struktur wird von den Routinen AllocateContiguousDmaBuffer und SetupDmaEngineWithBdl verwendet.

Weitere Informationen zu BDLs finden Sie in der Intel High Definition Audio Specification auf der Intel HD Audio-Website .

Anforderungen

Anforderung Wert
Header hdaudio.h (hdaudio.h einschließen)

Weitere Informationen

AllocateContiguousDmaBuffer

SetupDmaEngineWithBdl