AcxFactoryCircuitAddElements function (acxcircuit.h)

The AcxFactoryCircuitAddElements function adds elements to an ACXFACTORYCIRCUIT.

Syntax

NTSTATUS AcxFactoryCircuitAddElements(
  ACXFACTORYCIRCUIT Circuit,
  ACXELEMENT        *Elements,
  ULONG             ElementsCount
);

Parameters

Circuit

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

Elements

One or more ACXELEMENT objects.

ElementsCount

The number of elements that will be added to the factory 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

The driver can only add elements to a circuit factory before the factory is added to the device.

The driver cannot change the factory's elements at run time.

Example

Example usage is shown below.


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