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) |