SerCx2PioTransmitInitializeTransactionComplete function (sercx.h)

Article
10/21/2021

The SerCx2PioTransmitInitializeTransactionComplete 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 PIO-transmit transaction.

Syntax

void SerCx2PioTransmitInitializeTransactionComplete(
  [in] SERCX2PIOTRANSMIT PioTransmit,
  [in] BOOLEAN           InitSuccess
);

Parameters

[in] PioTransmit

A SERCX2PIOTRANSMIT handle to a PIO-transmit object. The serial controller driver previously called the SerCx2PioTransmitCreate 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 initiates a PIO-transmit transaction, SerCx2 calls the EvtSerCx2PioTransmitInitializeTransaction event callback function, if it is implemented, to initialize the serial controller to perform the transaction. In response to this call, the driver should first do any initialization that is needed; then the driver must call SerCx2PioTransmitInitializeTransactionComplete to notify SerCx2. SerCx2 expects this notification and does not start the transaction until it is notified.

The serial controller driver must call SerCx2PioTransmitInitializeTransactionComplete only in response to a call to the EvtSerCx2PioTransmitInitializeTransaction function.

For more information, see SerCx2 PIO-Transmit Transactions.

Requirements

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