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

メモリ不足の状況でフレームワークが使用のために予約しようとする要求オブジェクトの数。この番号は 0 より大きくなければなりません。

戻り値

なし

解説

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 要求がページング操作である場合にのみ、メモリ不足の状況で予約済み要求の 1 つを使用することを指定しています。

#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
    );