función WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP (wdfrequest.h)

Artículo
02/29/2024

[Se aplica a KMDF y UMDF]

La función WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP establece un nuevo IRP en la estructura de WDF_REQUEST_REUSE_PARAMS de un controlador.

Sintaxis

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

Parámetros

[in, out] Params

Puntero a una estructura de WDF_REQUEST_REUSE_PARAMS proporcionada por el autor de la llamada.

[in] NewIrp

Puntero a una estructura IRP proporcionada por el autor de la llamada.

Valor devuelto

None

Observaciones

Si la llamada de un controlador a WdfRequestReuse especifica una nueva estructura IRP, el controlador primero debe llamar a WDF_REQUEST_REUSE_PARAMS_INIT y, a continuación, llamar a WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP para inicializar una estructura de WDF_REQUEST_REUSE_PARAMS.

La función WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP establece el miembro NewIrp de la estructura en el puntero IRP especificado. También establece la marca WDF_REQUEST_REUSE_SET_NEW_IRP en el miembro Flag de la estructura.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_REQUEST_REUSE_PARAMS , se proporciona una nueva estructura IRP para la solicitud de E/S y, a continuación, se llama a 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
                         );
...