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