WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT (wdfio.h)

Artikel
02/27/2024

[Berlaku untuk KMDF saja]

Fungsi WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT menginisialisasi struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY driver.

Sintaks

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

Parameter

[out] Policy

Penunjuk ke struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY driver.

[in] TotalForwardProgressRequests

Jumlah objek permintaan yang akan dicoba oleh kerangka kerja untuk digunakan dalam situasi memori rendah. Nomor ini harus lebih besar dari nol.

Nilai kembali

Tidak ada

Keterangan

Fungsi WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT nol struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY yang ditentukan dan menetapkan anggota Ukurannya . Ini juga menetapkan anggota ForwardProgressReservedPolicy ke WdfIoForwardProgressReservedPolicyUseExamine.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY lalu memanggil WdfIoQueueAssignForwardProgressPolicy. Dalam contoh, driver menentukan bahwa kerangka kerja harus mengalokasikan dan memesan 10 objek permintaan untuk situasi memori rendah, dan bahwa kerangka kerja harus menggunakan salah satu permintaan yang dipesan selama situasi memori rendah hanya jika permintaan I/O adalah operasi paging.

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