enumerasi WDF_REQUEST_TYPE (wudfddi_types.h)
[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. |
Keterangan
Enumerasi WDF_REQUEST_TYPE digunakan sebagai parameter input IWDFDevice::ConfigureRequestDispatching dan IWDFIoQueue::ConfigureRequestDispatching. Ini juga digunakan untuk nilai pengembalian IWDFIoRequest::GetType dan IWDFRequestCompletionParams::GetCompletedRequestType.
Untuk versi KMDF enumerasi ini, lihat WDF_REQUEST_TYPE.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | wudfddi_types.h (termasuk Wudfddi.h) |
Lihat juga
IFileCallbackCleanup::OnCleanupFile
IFileCallbackClose::OnCloseFile
IQueueCallbackCreate::OnCreateFile