EVT_ACX_OBJECT_PREPROCESS_REQUEST - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// acxrequest.h

EVT_ACX_OBJECT_PREPROCESS_REQUEST EvtAcxObjectPreprocessRequest;

VOID EvtAcxObjectPreprocessRequest(
  ACXOBJECT Object,
  ACXCONTEXT DriverContext,
  WDFREQUEST Request
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-acxrequest-evt_acx_object_preprocess_request)

Description

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

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.

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.

See also