EVT_WDF_DMA_ENABLER_DISABLE callback function (wdfdmaenabler.h)
[Applies to KMDF only]
A driver's EvtDmaEnablerDisable event callback function disables a device's DMA capability before the device leaves its working (D0) state.
Syntax
EVT_WDF_DMA_ENABLER_DISABLE EvtWdfDmaEnablerDisable;
NTSTATUS EvtWdfDmaEnablerDisable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parameters
[in] DmaEnabler
A handle to a DMA enabler object.
Return value
EvtDmaEnablerDisable must return STATUS_SUCCESS or another status value for which NT_SUCCESS(status) equals TRUE, if it encounters no errors. Otherwise, this callback function must return a status value for which NT_SUCCESS(status) equals FALSE.
Remarks
To register an EvtDmaEnablerDisable callback function, a function driver for a DMA device places the callback function's address in a WDF_DMA_ENABLER_CONFIG structure before the driver calls WdfDmaEnablerCreate.
For more information about the EvtDmaEnablerDisable callback function, see Supporting Power Management for DMA Devices.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Minimum KMDF version | 1.0 |
| Header | wdfdmaenabler.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |