IWDFIoQueue::ConfigureRequestDispatching method (wudfddi.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.]
Metode ConfigureRequestDispatching mengonfigurasi antrean permintaan I/O dari jenis yang diberikan.
Sintaks
HRESULT ConfigureRequestDispatching(
[in] WDF_REQUEST_TYPE RequestType,
[in] BOOL Forward
);
Parameter
[in] RequestType
Nilai berjenis WDF_REQUEST_TYPE yang mengidentifikasi jenis permintaan yang akan diantrekan. Satu-satunya nilai yang valid adalah WdfRequestCreate, WdfRequestRead, WdfRequestWrite, dan WdfRequestDeviceIoControl.
[in] Forward
Nilai BOOL yang menentukan apakah permintaan dari jenis yang ditentukan diantrekan. TRUE menunjukkan untuk mengaktifkan permintaan antrean; FALSE menunjukkan untuk menonaktifkan permintaan antrean.
Nilai kembali
ConfigureRequestDispatching mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.
Keterangan
Driver dapat memanggil metode ConfigureRequestDispatching beberapa kali untuk mengonfigurasi bagaimana setiap jenis permintaan dikirim ke antrean I/O.
Contoh
Contoh kode berikut menunjukkan cara mengonfigurasi penerusan untuk permintaan IOCTL.
//
// Configure forwarding for IOCTL requests
//
HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
WdfRequestDeviceIoControl,
true
);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |