WdfDmaTransactionSetChannelConfigurationCallback function

• 02/26/2018
• 2 minutes to read

[Applies to KMDF only]

The WdfDmaTransactionSetChannelConfigurationCallback method registers a channel configuration event callback function for a system-mode DMA transaction.

Syntax

void WdfDmaTransactionSetChannelConfigurationCallback(
  WDFDMATRANSACTION                             DmaTransaction,
  PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  PVOID                                         ConfigureContext
);

Parameters

DmaTransaction

A handle to an initialized DMA transaction object for which to set or clear the channel configuration callback.

ConfigureRoutine

A pointer to the driver's EvtDmaTransactionConfigureDmaChannel event callback function, or NULL to clear it.

ConfigureContext

A pointer to a buffer containing the context to be provided to the driver's EvtDmaTransactionConfigureDmaChannel event callback function, or NULL.

Return Value

This method does not return a value.

Remarks

This method allows the driver to customize the adapter configuration before programming the system DMA controller.

Typically from within an I/O queue event callback function, a driver performs the following steps, in this order:

1. Calls WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize, or WdfDmaTransactionInitializeUsingOffset to initialize the transaction object.
2. Calls WdfDmaTransactionSetChannelConfigurationCallback on the transaction object.
3. Calls WdfDmaTransactionExecute.

WdfDmaTransactionSetChannelConfigurationCallback must be used with a DMA enabler that specifies a system-mode DMA profile.

If your driver calls this method on an operating system earlier than Windows 8, the framework's verifier reports an error.

Requirements

See Also

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease