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

See also

EvtDmaEnablerEnable

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate