AcxFactoryCircuitInitFree - NtDoc

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

VOID AcxFactoryCircuitInitFree(
  PACXFACTORYCIRCUIT_INIT FactoryInit
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

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

Description

The AcxFactoryCircuitInitFree function deletes the factory circuit initialization object.

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.

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.

See also