SerCx2SystemDmaReceiveInitializeTransactionComplete function (sercx.h)

Article
02/22/2024

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

Syntax

void SerCx2SystemDmaReceiveInitializeTransactionComplete(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive,
  [in] BOOLEAN                InitSuccess
);

Parameters

[in] SystemDmaReceive

A SERCX2SYSTEMDMARECEIVE handle to a system-DMA-receive object. The serial controller driver previously called the SerCx2SystemDmaReceiveCreate 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 system-DMA-receive transaction, SerCx2 calls the EvtSerCx2SystemDmaReceiveInitializeTransaction 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 SerCx2SystemDmaReceiveInitializeTransactionComplete to notify SerCx2. SerCx2 expects this notification and does not start the transaction until it is notified.

The serial controller driver must call SerCx2SystemDmaReceiveInitializeTransactionComplete only in response to a call to the EvtSerCx2SystemDmaReceiveInitializeTransaction function.

For more information, see SerCx2 System-DMA-Receive Transactions.

Requirements

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