WDF_REQUEST_REUSE_PARAMS structure (wdfrequest.h)

Article
02/29/2024

[S’applique à KMDF et UMDF]

La structure WDF_REQUEST_REUSE_PARAMS spécifie les informations associées à une demande d’E/S réutilisée.

Syntaxe

typedef struct _WDF_REQUEST_REUSE_PARAMS {
  ULONG    Size;
  ULONG    Flags;
  NTSTATUS Status;
  PIRP     NewIrp;
} WDF_REQUEST_REUSE_PARAMS, *PWDF_REQUEST_REUSE_PARAMS;

Membres

Size

Taille, en octets, de cette structure.

Flags

OR au niveau du bit d’un ou de plusieurs indicateurs WDF_REQUEST_REUSE_FLAGS typés.

Status

Valeur NTSTATUS que le framework affecte à la requête.

NewIrp

Pointeur vers une structure IRP . La valeur de ce membre est facultative et peut être NULL.

Remarques

La structure WDF_REQUEST_REUSE_PARAMS est utilisée comme entrée dans WdfRequestReuse.

Pour initialiser cette structure, le pilote doit appeler WDF_REQUEST_REUSE_PARAMS_INIT. Pour définir une valeur NewIrp dans la structure, le pilote doit appeler WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP après avoir appelé WDF_REQUEST_REUSE_PARAMS_INIT.

Si un pilote inférieur doit accéder à la valeur Status, il peut la trouver dans le champ Irp-IoStatus.Status>.

Vous pouvez définir une valeur NewIrp uniquement si la demande d’E/S que vous fournissez à WdfRequestReuse a été créée en appelant WdfRequestCreate ou WdfRequestCreateFromIrp.