AcxFactoryCircuitInitSetComponentId function (acxcircuit.h)

  • Article

The AcxFactoryCircuitInitSetComponentId function sets the component ID for the ACXFACTORYCIRCUIT.

Syntax

void AcxFactoryCircuitInitSetComponentId(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  const GUID              *ComponentId
);

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.

ComponentId

A defined GUID that serves as the component ID for the circuit factory.

Return value

None

Remarks

The driver must initialize the circuit factory's identity by setting its URI (AcxFactoryCircuitInitAssignComponentUri) and/or its ID (this DDI).

Example

Example usage is shown below.

DEFINE_GUID(SDCAXU_FACTORY_GUID, 
0xa8215305, 0xe7db, 0x49eb, 0x96, 0x49, 0x84, 0x34, 0x55, 0xe2, 0xe0, 0xd1);
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &SDCAXU_FACTORY_GUID);

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