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