enumerasi WDF_REQUEST_TYPE (wudfddi_types.h)

Artikel
08/08/2023

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Enumerasi WDF_REQUEST_TYPE mengidentifikasi jenis permintaan I/O yang dapat diwakili objek permintaan UMDF.

Sintaks

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

Konstanta


`WdfRequestUndefined` Jenis objek permintaan tidak ditentukan.
`WdfRequestCreate` Objek permintaan mewakili permintaan pembuatan file. Driver menerima jenis objek permintaan ini ketika aplikasi membuka perangkat dengan memanggil fungsi Microsoft Win32 CreateFile . Kerangka kerja mengirimkan jenis permintaan ini, bersama dengan objek file yang baru dibuat (IWDFFile), ke fungsi panggilan balik IQueueCallbackCreate::OnCreateFile driver. Objek file baru mewakili handel file jenis HANDLE yang dikembalikan Win32 CreateFile .
`WdfRequestCleanup` Objek permintaan mewakili permintaan pembersihan file. Driver menerima jenis objek permintaan ini setelah panggilan aplikasi ke fungsi Win32 CloseHandle menutup handel terakhir ke objek file, tetapi mungkin sebelum semua permintaan I/O file yang beredar telah selesai atau dibatalkan. Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IFileCallbackCleanup::OnCleanupFile driver. (Lihat juga WdfRequestClose.)
`WdfRequestRead` Objek permintaan mewakili permintaan baca. Driver ini menerima jenis permintaan I/O ini ketika aplikasi memanggil fungsi Win32 ReadFile atau ReadFileEx . Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackRead::OnRead driver.
`WdfRequestWrite` Objek permintaan mewakili permintaan tulis. Driver ini menerima jenis permintaan I/O ini ketika aplikasi memanggil fungsi Win32 WriteFile atau WriteFileEx . Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackWrite::OnWrite driver.
`WdfRequestDeviceIoControl` Objek permintaan mewakili permintaan kontrol I/O perangkat. Driver ini menerima jenis permintaan I/O ini ketika aplikasi memanggil fungsi Win32 DeviceIoControl . Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackDeviceIoControl::OnDeviceIoControl driver.
`WdfRequestClose` Objek permintaan mewakili permintaan penutupan file. Driver menerima jenis objek permintaan ini setelah panggilan aplikasi ke fungsi Win32 CloseHandle menutup handel terakhir ke objek file, dan setelah semua permintaan I/O file yang luar biasa telah selesai atau dibatalkan. Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IFileCallbackClose::OnCloseFile driver. (Lihat juga WdfRequestCleanup.)
`WdfRequestUsb` Objek permintaan dikirim ke port USB. Metode IWDFRequestCompletionParams::GetCompletedRequestType dapat mengembalikan nilai ini.
`WdfRequestOther` Nilai ini hanya dicadangkan untuk penggunaan internal.
`WdfRequestInternalIoctl` Nilai ini hanya dicadangkan untuk penggunaan internal.
`WdfRequestTypeNoFormat` Tipe objek permintaan belum ditentukan.
`WdfRequestFlushBuffers` Objek permintaan mewakili permintaan untuk membersihkan buffer yang di-cache. Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackDefaultIoHandler::OnDefaultIoHandler driver.
`WdfRequestQueryInformation` Objek permintaan mewakili permintaan untuk mendapatkan informasi tentang file. Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackDefaultIoHandler::OnDefaultIoHandler driver.
`WdfRequestSetInformation` Objek permintaan mewakili permintaan untuk mengatur informasi tentang file. Kerangka kerja mengirimkan jenis permintaan ini ke fungsi panggilan balik IQueueCallbackDefaultIoHandler::OnDefaultIoHandler driver.
`WdfRequestMaximum` Nilai maksimum untuk enumerasi terlampaui.