EVT_WDF_DMA_ENABLER_FLUSH callback function (wdfdmaenabler.h)

[Applies to KMDF only]

A driver's EvtDmaEnablerFlush event callback function deallocates a device's DMA buffers.

Syntax

EVT_WDF_DMA_ENABLER_FLUSH EvtWdfDmaEnablerFlush;

NTSTATUS EvtWdfDmaEnablerFlush(
  [in] WDFDMAENABLER DmaEnabler
)
{...}

Parameters

[in] DmaEnabler

A handle to a DMA enabler object.

Return value

EvtDmaEnablerFlush 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 EvtDmaEnablerFlush 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 EvtDmaEnablerFlush 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

EvtDmaEnablerFill

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate