AcxCircuitInitFree - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// acxcircuit.h

VOID AcxCircuitInitFree(
  PACXCIRCUIT_INIT CircuitInit
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-acxcircuit-acxcircuitinitfree)

Description

The AcxCircuitInitFree function deletes the circuit initialization object.

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.

Remarks

This function does not return a value.

The driver is responsible for deleting the ACXCIRCUIT_INIT object using this DDI if the AcxCircuitCreate is not invoked or returns an error.

Example

Example usage is shown below.

    //
    // Get a CircuitInit structure.
    //
    PACXCIRCUIT_INIT circuitInit = NULL;
    circuitInit = AcxCircuitInitAllocate(Device);

// Later in the code on an exit close down process...

exit:
    if (!NT_SUCCESS(status))
    {
        if (circuitInit)
        {
            AcxCircuitInitFree(circuitInit);
        }
    }

ACX requirements

Minimum ACX version: 1.0

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

See also