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