SerCx2SystemDmaTransmitGetDmaEnabler function (sercx.h)

Article
02/22/2024

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

Requirement	Value
Minimum supported client	Available starting with Windows 8.1.
Target Platform	Universal
Header	sercx.h
IRQL	<= DISPATCH_LEVEL

Share via