Edit

AcxCircuitGetElementById function (acxcircuit.h)

  • Article

When provided a valid ElementID number, the AcxCircuitGetElementById function returns the corresponding ACXELEMENT object. For more information about ACX objects, see Summary of ACX Objects.

Syntax

ACXELEMENT AcxCircuitGetElementById(
  ACXCIRCUIT Circuit,
  ULONG      ElementId
);

Parameters

Circuit

An existing ACXCIRCUIT object.

ElementId

A valid Element ID number.

Return value

The requested ACXELEMENT object associated with the provided element ID number.

Remarks

Example

Example usage is shown below.

    ACXELEMENT              element     = nullptr;
    ULONGLONG               index       = GetMessageContext(Event); // Context is an index.

    element = AcxCircuitGetElementById(Circuit, (ULONG)index);

ACX requirements

Minimum ACX version: 1.0

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

Requirements

Requirement Value
Header acxcircuit.h
IRQL <= DISPATCH_LEVEL

See also