função WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP (wdfrequest.h)

Artigo
08/08/2023

[Aplica-se a KMDF e UMDF]

A função WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP define um novo IRP na estrutura de WDF_REQUEST_REUSE_PARAMS de um driver.

Sintaxe

void WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
  [in, out] PWDF_REQUEST_REUSE_PARAMS Params,
  [in]      PIRP                      NewIrp
);

Parâmetros

[in, out] Params

Um ponteiro para uma estrutura de WDF_REQUEST_REUSE_PARAMS fornecida pelo chamador.

[in] NewIrp

Um ponteiro para uma estrutura IRP fornecida pelo chamador.

Retornar valor

Nenhum

Comentários

Se a chamada de um driver para WdfRequestReuse especificar uma nova estrutura IRP, o driver deverá primeiro chamar WDF_REQUEST_REUSE_PARAMS_INIT e, em seguida, chamar WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP para inicializar uma estrutura WDF_REQUEST_REUSE_PARAMS.

A função WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP define o membro NewIrp da estrutura como o ponteiro IRP especificado. Ele também define o sinalizador WDF_REQUEST_REUSE_SET_NEW_IRP no membro Sinalizador da estrutura.

Exemplos

O exemplo de código a seguir inicializa uma estrutura WDF_REQUEST_REUSE_PARAMS , fornece uma nova estrutura IRP para a solicitação de E/S e chama WdfRequestReuse.

WDF_REQUEST_REUSE_PARAMS  params;
NTSTATUS  status;
PIRP  myIrp;
...
WDF_REQUEST_REUSE_PARAMS_INIT(
                              &params,
                              WDF_REQUEST_REUSE_NO_FLAGS,
                              STATUS_SUCCESS
                              );
WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP(
                                     &params,
                                     myIrp
                                     );
status = WdfRequestReuse(
                         Request,
                         &params
                         );
...