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