Edit

Share via

AcxFactoryCircuitInitFree function (acxcircuit.h)

  • Article

The AcxFactoryCircuitInitFree function deletes the factory circuit initialization object.

Syntax

void AcxFactoryCircuitInitFree(
  PACXFACTORYCIRCUIT_INIT FactoryInit
);

Parameters

FactoryInit

An ACXFACTORYCIRCUIT_INIT structure that is used for circuit factory initialization. This is an opaque structure that is used to store ACX Circuit factory initialization information and associate the factory with a WDF device.

Use the AcxFactoryCircuitInitAllocate function to initialize the ACXFACTORYCIRCUIT_INIT structure.

Return value

None

Remarks

This function does not return a value.

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

Example

Example usage is shown below.

// Get a FactoryCircuitInit structure

  ctrlInit = AcxFactoryCircuitInitAllocate(Device);

...

// Example exit routine that shows freeing an example init structure

exit:
    if (!NT_SUCCESS(status))
    {
        if (ctrlInit)
        {
            AcxFactoryCircuitInitFree(ctrlInit);
            ctrlInit = nullptr;
        }
    }

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