AcxCircuitGetSymbolicLinkName function (acxcircuit.h)

The AcxCircuitGetSymbolicLinkName function retrieves the symbolic link name for the specified circuit object.

Syntax

WDFSTRING AcxCircuitGetSymbolicLinkName(
  [in] ACXCIRCUIT Circuit
);

Parameters

[in] Circuit

The circuit object for which to get the symbolic link name.

Return value

Returns a string containing the symbolic link name for the object specified by the Circuit parameter.

Remarks

The symbolic link is valid:

  1. After the driver adds the circuit to the device, for single-circuit endpoints.
  2. When the ACX manager invokes ACX circuit initialization, for multi-circuit endpoints.

Example

Example usage is shown below.

...
    _In_ ACXCIRCUIT Circuit,
...

    WDFSTRING wdfLink = AcxCircuitGetSymbolicLinkName(Circuit);

ACX requirements

Minimum ACX version: 1.1

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

Requirements

Requirement Value
Header acxcircuit.h
IRQL PASSIVE_LEVEL

See also