PGET_DMA_ALIGNMENT回调函数 (wdm.h)

GetDmaAlignment 例程返回 DMA 系统的对齐要求。

语法

PGET_DMA_ALIGNMENT PgetDmaAlignment;

ULONG PgetDmaAlignment(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

参数

[in] DmaAdapter

指向 IoGetDmaAdapter 返回的DMA_ADAPTER结构的指针,该结构表示总线主适配器或 DMA 控制器。

返回值

GetDmaAlignment 返回 DMA 系统的对齐要求(以字节为单位)。 DMA 缓冲区的起始地址和长度必须是此值的倍数。

注解

GetDmaAlignment 不是可直接按名称调用的系统例程。 此例程只能由 DMA_OPERATIONS结构中 返回的地址中的指针调用。 驱动程序通过调用 IoGetDmaAdapter 获取此例程的地址。

驱动程序可以调用此例程来确定其分配的 DMA 缓冲区的对齐要求。 返回的值应用于在设备对象中设置 AlignmentRequirement 字段。 由于其他硬件设备限制,驱动程序可能需要增加此值。 有关详细信息,请参阅 初始化设备对象

要求

要求
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 桌面
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL PASSIVE_LEVEL
DDI 符合性规则 IrqlDispatch (wdm)

另请参阅

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter