EVT_WDF_DMA_ENABLER_FILL callback function (wdfdmaenabler.h)

[Applies to KMDF only]

A driver's EvtDmaEnablerFill event callback function allocates a device's DMA buffers.

Syntax

EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;

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

Parameters

[in] DmaEnabler

A handle to a DMA enabler object.

Return value

EvtDmaEnablerFill 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 EvtDmaEnablerFill 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 EvtDmaEnablerFill callback function, see Supporting Power Management for DMA Devices.

The EvtDmaEnablerFill callback function is called at IRQL = PASSIVE_LEVEL. You should not make this callback function pageable.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfdmaenabler.h (include Wdf.h)
IRQL PASSIVE_LEVEL (see Remarks section)

See also

EvtDmaEnablerFlush

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate