fungsi WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT (wdfio.h)

[Hanya berlaku untuk KMDF]

Fungsi WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT menginisialisasi struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY driver.

Sintaks

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY   Policy,
  [in]  ULONG                                   TotalForwardProgressRequests,
  [in]  PFN_WDF_IO_WDM_IRP_FOR_FORWARD_PROGRESS EvtIoWdmIrpForForwardProgress
);

Parameter

[out] Policy

Penunjuk ke struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY driver.

[in] TotalForwardProgressRequests

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

[in] EvtIoWdmIrpForForwardProgress

Penunjuk ke fungsi panggilan balik EvtIoWdmIrpForwardProgress driver.

Nilai kembali

Tidak ada

Keterangan

Fungsi WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT nol struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY yang ditentukan dan menetapkan anggota Ukurannya . Ini juga menetapkan anggota TotalForwardProgressRequests danForwardProgressReservePolicySettings.Policy.ExaminePolicy.EvtIoWdmIrpForforwardProgress ke nilai yang ditentukan, dan mengatur 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 memanggil fungsi panggilan balik MyIoForwardExamineIrpForwardProgress driver sebelum menggunakan salah satu objek permintaan yang dipesan.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS,
    MyIoForwardExamineIrpForForwardProgress
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.9
Header	wdfio.h (termasuk Wdf.h)

Lihat juga

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT

WdfIoQueueAssignForwardProgressPolicy