Edit

AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback function (acxcircuit.h)

  • Article

The AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback function initializes defined AssignAcxRequest Preprocess callbacks for circuit factories.

Syntax

NTSTATUS AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback(
  PACXFACTORYCIRCUIT_INIT           FactoryInit,
  PFN_ACX_OBJECT_PREPROCESS_REQUEST EvtObjectAcxRequestPreprocess,
  ACXCONTEXT                        DriverContext,
  ACX_REQUEST_TYPE                  RequestType,
  const GUID                        *Set,
  ULONG                             Id
);

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.

EvtObjectAcxRequestPreprocess

A pointer to a EVT_ACX_OBJECT_PREPROCESS_REQUEST callback.

DriverContext

The driver context defined by the ACXCONTEXT object. For more information about ACX objects, see Summary of ACX Objects.

RequestType

An ACX_REQUEST_TYPE enum that defines different request types, such as AcxRequestTypeAny, AcxRequestTypeProperty, etc.

Set

Optional GUID to identify a specific item set ID.

Id

An ID to identify a specific item in the specified set ID.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

The driver can invoke this DDI multiple times to setup different preprocess callbacks. ACX invokes the first it finds that matches the specific incoming WDFREQUEST type.

ACX requirements

Minimum ACX version: 1.0

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

Requirements

Requirement Value
Header acxcircuit.h
IRQL PASSIVE_LEVEL

See also