AcxStreamStopIoWithTag - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// acxstreams.h

void AcxStreamStopIoWithTag(
  Stream,
  Flags,
  Tag
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-acxstreams-acxstreamstopiowithtag)

Description

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.

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.

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.

See also

View the official Windows Driver Kit DDI reference

Edit description on GitHub