WDF_REQUEST_REUSE_PARAMS structure (wdfrequest.h)

[Applies to KMDF and UMDF]

The WDF_REQUEST_REUSE_PARAMS structure specifies information that is associated with a reused I/O request.

Syntax

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

Members

Size

The size, in bytes, of this structure.

Flags

A bitwise OR of one or more WDF_REQUEST_REUSE_FLAGS-typed flags.

Status

An NTSTATUS value that the framework assigns to the request.

NewIrp

A pointer to an IRP structure. This member's value is optional and can be NULL.

Remarks

The WDF_REQUEST_REUSE_PARAMS structure is used as input to WdfRequestReuse.

To initialize this structure, the driver must call WDF_REQUEST_REUSE_PARAMS_INIT. To set a NewIrp value in the structure, the driver must call WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP after calling WDF_REQUEST_REUSE_PARAMS_INIT.

If a lower driver needs to access the Status value, it can find it in the Irp->IoStatus.Status field.

You can set a NewIrp value only if the I/O request that you supply to WdfRequestReuse was created by calling WdfRequestCreate or WdfRequestCreateFromIrp.

Requirements

See also

WDF_REQUEST_REUSE_FLAGS

WDF_REQUEST_REUSE_PARAMS_INIT

WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP

WdfRequestCreateFromIrp

WdfRequestReuse