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 jenis 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.

Mengembalikan nilai

ConfigureRequestDispatching mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan 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

   
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