AcxCircuitStopIo macro (acxcircuit.h)

Article
02/22/2024

The AcxCircuitStopIo function is used to signal to the operating system to temporarily stop circuit I/O. This allows the driver a short period of time to run time sensitive task, and resume IO after the execution of time sensitive code is complete.

Syntax

void AcxCircuitStopIo(
   Circuit,
   Flags
);

Parameters

Circuit

An existing ACXCIRCUIT circuit object. For more information about ACX objects, see Summary of ACX Objects.

Flags

Stop IO flags defined by the ACX_STOP_IO_FLAGS enumeration. Currently no flags are defined, so set this to AcxStopIoNoFlags.

Return value

None

Remarks

It is not recommended to use this version of the stop IO call, but rather AcxCircuitStopIoWithTag macro as it provides additional diagnostic information by using a Tag.

Example

Example usage is shown below.

    // Temporarily disable this circuit's I/Os while we are updating the 
    // formats. This thread cannot be an I/O dispatched thread else we deadlock.
    //
    status = AcxCircuitStopIo(circuit, AcxStopIoNoFlags);

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement	Value
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

Share via