fungsi WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi WDF_IO_QUEUE_CONFIG_INIT menginisialisasi struktur WDF_IO_QUEUE_CONFIG driver.

Sintaks

void WDF_IO_QUEUE_CONFIG_INIT(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Parameter

[out] Config

Penunjuk ke struktur WDF_IO_QUEUE_CONFIG driver.

[in] DispatchType

Enumerator WDF_IO_QUEUE_DISPATCH_TYPE yang mengidentifikasi jenis pengiriman permintaan untuk antrean.

Nilai kembali

Tidak ada

Keterangan

Driver harus memanggil WDF_IO_QUEUE_CONFIG_INIT saat membuat antrean I/O yang dikelola daya yang bukan antrean default perangkat. Fungsi WDF_IO_QUEUE_CONFIG_INIT nol struktur WDF_IO_QUEUE_CONFIG yang ditentukan dan menetapkan anggota Ukurannya . Ini juga mengatur anggota PowerManaged ke WdfUseDefault dan menyimpan jenis pengiriman yang ditentukan di anggota DispatchType .

Mulai dari KMDF versi 1.9, jika DispatchType diatur ke WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT mengatur anggota NumberOfPresentedRequests struktur ke -1. Nilai ini menunjukkan bahwa kerangka kerja dapat mengirimkan jumlah permintaan I/O yang tidak terbatas ke driver.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_IO_QUEUE_CONFIG lalu memanggil WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );