[仅适用于 KMDF]
驱动程序的 EvtDmaEnablerFill 事件回调函数分配设备的 DMA 缓冲区。
语法
EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;
NTSTATUS EvtWdfDmaEnablerFill(
[in] WDFDMAENABLER DmaEnabler
)
{...}
参数
[in] DmaEnabler
DMA 启用器对象的句柄。
返回值
EvtDmaEnablerFill 必须返回STATUS_SUCCESS或其他状态值(NT_SUCCESS状态)等于 true,如果它遇到错误。 否则,此回调函数必须返回一个状态值,NT_SUCCESS(状态)等于 FALSE。
注解
若要注册 EvtDmaEnablerFill 回调函数,DMA 设备的函数驱动程序在驱动程序调用 WdfDmaEnablerCreate之前将回调函数的地址置于 WDF_DMA_ENABLER_CONFIG 结构中。
有关 EvtDmaEnablerFill 回调函数的详细信息,请参阅 支持 DMA 设备的电源管理。
在 IRQL = PASSIVE_LEVEL 调用 EvtDmaEnablerFill 回调函数。 不应将此回调函数 可分页。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfdmaenabler.h (包括 Wdf.h) |
| IRQL | PASSIVE_LEVEL(请参阅“备注”部分) |