EVT_ACX_OBJECT_PREPROCESS_REQUEST função de retorno de chamada (acxrequest.h)

Artigo
02/06/2025

O retorno de chamada EVT_ACX_OBJECT_PREPROCESS_REQUEST é usado pelo driver para pré-processar WDFREQUESTs de E/S.

Sintaxe

EVT_ACX_OBJECT_PREPROCESS_REQUEST EvtAcxObjectPreprocessRequest;

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

Parâmetros

Object

Um objeto ACX associado à solicitação. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

DriverContext

O contexto do driver definido pelo objeto ACXCONTEXT.

Request

Um objeto WDFREQUEST.

Para obter mais informações sobre como trabalhar com objetos de solicitação do WDF, consulte Criando objetos de solicitação da estrutura e cabeçalho wdfrequest.h.

Valor de retorno

Nenhum

Observações

Exemplo

O uso de exemplo é mostrado abaixo.

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);
}

Requisitos do ACX

versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.

Requisitos

Requisito	Valor
cabeçalho	acxrequest.h
IRQL	PASSIVE_LEVEL

Consulte também

de cabeçalho acxrequest.h

Compartilhar via