AcxCircuitAddEvents function (acxcircuit.h)

The AcxCircuitAddEvents function adds one or more events to an ACXCIRCUIT.

Syntax

NTSTATUS AcxCircuitAddEvents(
  ACXCIRCUIT Circuit,
  ACXEVENT   *Events,
  ULONG      EventsCount
);

Parameters

Circuit

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

Events

An existing ACXEVENT object containing one or more events.

EventsCount

The number of events that will be added to the circuit. This is a one based count.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

An AcxEvent represents an asynchronous notification available at the driver level. Events can be added to AcxCircuits, AcxStreams, AcxElements and AcxPins. They are exposed as KS events to clients (upper user-mode layers).

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

See also