AcxStreamStopIoWithTag macro (acxstreams.h)

Article
02/22/2024

The AcxStreamStopIoWithTag function is used to signal to the operating system to temporarily stop stream IO. This allows the driver a short period of time to run time sensitive tasks, and then resume IO after the execution of time sensitive code is complete.

Syntax

void AcxStreamStopIoWithTag(
   Stream,
   Flags,
   Tag
);

Parameters

Stream

An existing ACXSTREAM Object. For more information, see ACX - Summary of ACX Objects.

Flags

Set to AcxStopIoNoFlags.

Tag

An optional Tag that is a driver-defined value that the framework includes with diagnostic tracing.

Return value

None

Remarks

Do not call AcxStreamStopIoWithTag from an I/O dispatched thread. This will cause a deadlock.

Example

Example usage is shown below.


    //
    // Temporarily disable this stream's I/Os. This thread cannot be an I/O dispatched thread else we deadlock.
    //
    status = AcxStreamStopIoWithTag(stream, AcxStopIoNoFlags, (PVOID)this);

ACX requirements

Minimum ACX version: 1.0

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

Requirements

Requirement	Value
Header	acxstreams.h
IRQL	PASSIVE_LEVEL

Share via