Edit

AcxCircuitInitSetComponentId function (acxcircuit.h)

  • Article

The AcxCircuitInitSetComponentId function sets the component ID for the ACXCIRCUIT.

Syntax

void AcxCircuitInitSetComponentId(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *ComponentId
);

Parameters

CircuitInit

The ACXCIRCUIT_INIT structure that defines the circuit initialization. ACXCIRCUIT_INIT is an opaque object used for circuit initialization. Use AcxCircuitInitAllocate to initialize the ACXCIRCUIT_INIT structure.

ComponentId

A pointer to a defined GUID that serves as the component ID for the circuit.

Return value

None

Remarks

The driver must initialize the circuit's identity by setting the its URI (AcxCircuitInitAssignComponentUri) and/or its ID (this DDI).

Example

Example usage is shown below.

DEFINE_GUID(COMPONENT_GUID, 
0xf55ba68e, 0x4384, 0x4030, 0x97, 0x19, 0xec, 0xa4, 0xbe, 0x27, 0x6c, 0xc8);

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

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