WDF_REQUEST_REUSE_PARAMS 结构 (wdfrequest.h)

项目
03/05/2024

[适用于 KMDF 和 UMDF]

WDF_REQUEST_REUSE_PARAMS 结构指定与重复使用的 I/O 请求关联的信息。

语法

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

成员

Size

此结构的大小（以字节为单位）。

Flags

一个或多个 WDF_REQUEST_REUSE_FLAGS类型标志的按位 OR。

Status

框架分配给请求的 NTSTATUS 值。

NewIrp

指向 IRP 结构的指针。此成员的值是可选的，可以为 NULL。

注解

WDF_REQUEST_REUSE_PARAMS 结构用作 WdfRequestReuse 的输入。

若要初始化此结构，驱动程序必须调用 WDF_REQUEST_REUSE_PARAMS_INIT。若要在结构中设置 NewIrp 值，驱动程序必须在调用 WDF_REQUEST_REUSE_PARAMS_INIT 后调用 WDF_REQUEST_REUSE_PARAMS_SET_NEW_IRP。

如果较低的驱动程序需要访问 Status 值，则可以在 Irp-IoStatus.Status> 字段中找到它。

仅当通过调用 WdfRequestCreate 或 WdfRequestCreateFromIrp 创建了提供给 WdfRequestReuse 的 I/O 请求时，才能设置 NewIrp 值。