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 位地址，地址应为右对齐，成员 () MSB) 的 32 个最有效位应为零。

Length

指定缓冲区片段的大小（以字节为单位）。

InterruptOnCompletion

指定 DMA 引擎是否应在完成缓冲区片段的传输时生成中断。 值为 1 可启用中断。 如果值为 0，则禁用它。

注解

BDL 是HDAUDIO_BUFFER_DESCRIPTOR结构的数组。 每个结构指定缓冲区的物理连续片段。 BDL 指定组成缓冲区的所有片段。

Address 成员包含缓冲区片段开头的物理内存地址。 Length 成员指定片段包含的物理连续内存的字节数。

如果在与缓冲区片段进行 DMA 传输期间设置了 InterruptOnCompletion 位，则 DMA 引擎会在传输完成后生成中断。

AllocateContiguousDmaBuffer 和 SetupDmaEngineWithBdl 例程使用此结构。

有关 BDL 的详细信息，请参阅 Intel HD Audio 网站上的 Intel 高清晰度 音频 规范。

要求

要求 值
Header hdaudio.h (包括 Hdaudio.h)

另请参阅

AllocateContiguousDmaBuffer

SetupDmaEngineWithBdl