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 成员指定片段包含的物理连续内存的字节数。

如果在 DMA 传输到缓冲区片段或从缓冲区片段传输期间设置了 InterruptOnCompletion 位,则 DMA 引擎会在传输完成后生成中断。

此结构由 AllocateContiguousDmaBufferSetupDmaEngineWithBdl 例程使用。

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

要求

要求 价值
标头 hdaudio.h (包括 Hdaudio.h)

另请参阅

AllocateContiguousDmaBuffer

SetupDmaEngineWithBdl