структура HDAUDIO_BUFFER_DESCRIPTOR (hdaudio.h)

  • Статья

Структура HDAUDIO_BUFFER_DESCRIPTOR задает дескриптор буфера, который является записью в списке дескрипторов буфера (BDL).

Синтаксис

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

Члены

Address

Указывает начальный адрес физически непрерывного фрагмента буфера. В случае 32-разрядного адреса адрес должен быть оправдан по правому краю, а 32 наиболее значимых бита (MSB) элемента должны быть равны нулю.

Length

Задает размер фрагмента буфера в байтах.

InterruptOnCompletion

Указывает, должен ли подсистема DMA создавать прерывание при завершении передачи фрагмента буфера. Значение 1 включает прерывание. Значение 0 отключает его.

Комментарии

BDL — это массив HDAUDIO_BUFFER_DESCRIPTOR структур. Каждая структура определяет физически смежный фрагмент буфера. BDL указывает все фрагменты, составляющие буфер.

Элемент Address содержит адрес физической памяти начала фрагмента буфера. Элемент Length указывает количество байтов физической непрерывной памяти, содержащейся в фрагменте.

Если бит InterruptOnCompletion задан во время передачи DMA в буферный фрагмент или из нее, подсистема DMA создает прерывание по завершении передачи.

Эта структура используется подпрограммами AllocateContiguousDmaBuffer и SetupDmaEngineWithBdl .

Дополнительные сведения о BDL см. в спецификации Intel High Definition Audio на веб-сайте Intel HD Audio .

Требования

Требование Значение
Заголовок hdaudio.h (включая Hdaudio.h)

См. также раздел

AllocateContiguousDmaBuffer

SetupDmaEngineWithBdl