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

Lihat juga

IWDFIoQueue

WDF_REQUEST_TYPE