WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT 函数 (wdfio.h)

项目
02/29/2024

[仅适用于 KMDF]

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT 函数初始化驱动程序的WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY结构。

语法

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
  [in]  ULONG                                 TotalForwardProgressRequests
);

参数

[out] Policy

指向驱动程序 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 结构的指针。

[in] TotalForwardProgressRequests

框架将尝试保留以在内存不足的情况下使用的请求对象数。数量必须大于零。

返回值

无

备注

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT函数将指定的WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY结构归零并设置其 Size 成员。它还将 ForwardProgressReservedPolicy 成员设置为 WdfIoForwardProgressReservedPolicyUseExamine。

示例

下面的代码示例初始化 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 结构，然后调用 WdfIoQueueAssignForwardProgressPolicy。在示例中，驱动程序指定框架应为内存不足的情况分配和保留 10 个请求对象，并且框架应仅在 I/O 请求为分页操作时才在内存不足的情况下使用其中一个保留请求。

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );