SerCx2SystemDmaTransmitGetDmaEnabler function (sercx.h)

The SerCx2SystemDmaTransmitGetDmaEnabler method gets the DMA enabler for the system DMA controller that is used for system-DMA-transmit transactions.

Syntax

WDFDMAENABLER SerCx2SystemDmaTransmitGetDmaEnabler(
  [in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit
);

Parameters

[in] SystemDmaTransmit

A SERCX2SYSTEMDMATRANSMIT handle to a system-DMA-transmit object. The serial controller driver previously called the SerCx2SystemDmaTransmitCreate method to create this object.

Return value

This method returns a WDFDMAENABLER handle to the framework DMA enabler object that represents the system DMA controller that is used for system-DMA-transmit transactions.

Remarks

If necessary, your serial controller driver can call this method to configure special features in the system DMA controller. The driver can use the DMA enabler returned by this method to specify DMA settings that were not supplied in the SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG structure that the driver previously passed as an input parameter to the SerCx2SystemDmaTransmitCreate method. Or, the driver can use the DMA enabler to change the DMA settings that were previously specified in this structure.

For more information about DMA enabler objects, see Enabling DMA Transactions. For more information about system-DMA-transmit transactions, see SerCx2 System-DMA-Transmit Transactions.

Requirements

See also

SERCX2SYSTEMDMATRANSMIT

SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG

SerCx2SystemDmaTransmitCreate