struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY (wdfio.h)

Artikel
02/29/2024

[Berlaku untuk KMDF saja]

Struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY berisi informasi yang disediakan driver yang digunakan kerangka kerja untuk mengaktifkan kemajuan penerusan yang terjamin untuk antrean I/O.

Sintaks

typedef struct _WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY {
  ULONG                                              Size;
  ULONG                                              TotalForwardProgressRequests;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY            ForwardProgressReservedPolicy;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS   ForwardProgressReservePolicySettings;
  PFN_WDF_IO_ALLOCATE_RESOURCES_FOR_RESERVED_REQUEST EvtIoAllocateResourcesForReservedRequest;
  PFN_WDF_IO_ALLOCATE_REQUEST_RESOURCES              EvtIoAllocateRequestResources;
} WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, *PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY;

Anggota

Size

Panjangnya, dalam byte, dari struktur ini.

TotalForwardProgressRequests

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

ForwardProgressReservedPolicy

Nilai WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY-ketik yang menentukan bagaimana kerangka kerja akan mengalokasikan objek permintaan selama situasi memori rendah.

ForwardProgressReservePolicySettings

Struktur WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS yang berisi nilai tambahan yang khusus untuk kebijakan yang ditentukan anggota ForwardProgressReservedPolicy . Anggota ini harus NULL kecuali driver menyediakan fungsi panggilan balik EvtIoWdmIrpForwardProgress .

EvtIoAllocateResourcesForReservedRequest

Penunjuk ke fungsi panggilan balik EvtIoAllocateResourcesForReservedRequest khusus driver, atau NULL.

EvtIoAllocateRequestResources

Penunjuk ke fungsi panggilan balik EvtIoAllocateRequestResources khusus antrean driver, atau NULL.

Keterangan

Struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY digunakan sebagai input ke metode WdfIoQueueAssignForwardProgressPolicy .

Driver harus menginisialisasi struktur WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY dengan memanggil WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT, atau WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT sebelum mereka memanggil WdfIoQueueAssignForwardProgressPolicy.

Persyaratan

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

Bagikan melalui