AcxFactoryCircuitInitFree function (acxcircuit.h)
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 |