EVT_ACX_OBJECT_PREPROCESS_REQUEST callback function (acxrequest.h)

Article
02/22/2024

The EVT_ACX_OBJECT_PREPROCESS_REQUEST callback is used by the driver to preprocess I/O WDFREQUESTs.

Syntax

EVT_ACX_OBJECT_PREPROCESS_REQUEST EvtAcxObjectPreprocessRequest;

void EvtAcxObjectPreprocessRequest(
  ACXOBJECT Object,
  ACXCONTEXT DriverContext,
  WDFREQUEST Request
)
{...}

Parameters

Object

An ACX object associated with the request. For more information about ACX objects, see Summary of ACX Objects.

DriverContext

The driver context defined by the ACXCONTEXT object.

Request

An WDFREQUEST object.

For more information about working with WDF request objects, see Creating Framework Request Objects and wdfrequest.h header.

Return value

None

Remarks

Example

Example usage is shown below.

EVT_ACX_OBJECT_PREPROCESS_REQUEST   CodecR_EvtCircuitRequestPreprocess;

...

VOID
CodecR_EvtCircuitRequestPreprocess(
    _In_    ACXOBJECT  Object,
    _In_    ACXCONTEXT DriverContext,
    _In_    WDFREQUEST Request
    )
/*++

Routine Description:

    This function is an example of a preprocess routine.

--*/
{
    PAGED_CODE();

    UNREFERENCED_PARAMETER(DriverContext);
    
    ASSERT(Object != NULL);
    ASSERT(DriverContext);
    ASSERT(Request);

    // Add the handling of the request here.
    // Driver is responsible for completing the request when done.

    //
    // Else, just give the request back to ACX.
    //
    (VOID)AcxCircuitDispatchAcxRequest((ACXCIRCUIT)Object, Request);
}

ACX requirements

Minimum ACX version: 1.0

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

Requirements

Requirement	Value
Header	acxrequest.h
IRQL	PASSIVE_LEVEL

Share via