WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP, fonction (wdfrequest.h)

Article
02/29/2024

[S’applique à KMDF et UMDF]

La fonction WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP définit une nouvelle IRP dans la structure de WDF_REQUEST_REUSE_PARAMS d’un pilote.

Syntaxe

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

Paramètres

[in, out] Params

Pointeur vers une structure de WDF_REQUEST_REUSE_PARAMS fournie par l’appelant.

[in] NewIrp

Pointeur vers une structure IRP fournie par l’appelant.

Valeur de retour

None

Remarques

Si l’appel d’un pilote à WdfRequestReuse spécifie une nouvelle structure IRP, le pilote doit d’abord appeler WDF_REQUEST_REUSE_PARAMS_INIT , puis appeler WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP pour initialiser une structure WDF_REQUEST_REUSE_PARAMS.

La fonction WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP définit le membre NewIrp de la structure sur le pointeur IRP spécifié. Il définit également l’indicateur WDF_REQUEST_REUSE_SET_NEW_IRP dans le membre Flag de la structure.

Exemples

L’exemple de code suivant initialise une structure WDF_REQUEST_REUSE_PARAMS , fournit une nouvelle structure IRP pour la requête d’E/S, puis appelle 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
                         );
...