SerCx2SystemDmaTransmitInitializeTransactionComplete function (sercx.h)

The SerCx2SystemDmaTransmitInitializeTransactionComplete method notifies version 2 of the serial framework extension (SerCx2) that the serial controller driver has finished initializing the serial controller hardware in preparation for a new system-DMA-transmit transaction.

Syntax

void SerCx2SystemDmaTransmitInitializeTransactionComplete(
  [in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
  [in] BOOLEAN                 InitSuccess
);

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.

[in] InitSuccess

Whether the initialization was successful. If TRUE, the initialization succeeded. If FALSE, the initialization failed.

Return value

None

Remarks

Before SerCx2 starts a system-DMA-transmit transaction, SerCx2 calls the EvtSerCx2SystemDmaTransmitInitializeTransaction event callback function, if it is implemented, to initialize the serial controller to perform the transaction. In response to this call, the driver should do any initialization that is needed; then the driver must call SerCx2SystemDmaTransmitInitializeTransactionComplete to notify SerCx2. SerCx2 expects this notification and does not start the transaction until it is notified.

The serial controller driver must call SerCx2SystemDmaTransmitInitializeTransactionComplete only in response to a call to the EvtSerCx2SystemDmaTransmitInitializeTransaction function.

For more information, see SerCx2 System-DMA-Transmit Transaction.

Requirements

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

See also

EvtSerCx2SystemDmaTransmitInitializeTransaction

SERCX2SYSTEMDMATRANSMIT

SerCx2SystemDmaTransmitCreate