Metode IQueueCallbackDeviceIoControl::OnDeviceIoControl (wudfddi.h)

Artikel
08/08/2023

Peringatan

UMDF 2 adalah versi terbaru UMDF dan supersedes 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 OnDeviceIoControl dipanggil untuk menangani permintaan kontrol I/O perangkat saat aplikasi melakukan operasi tertentu pada perangkat melalui fungsi Microsoft Win32 OnDeviceIoControl .

Sintaks

void OnDeviceIoControl(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ControlCode,
       SIZE_T        InputBufferSizeInBytes,
       SIZE_T        OutputBufferSizeInBytes
);

Parameter

[in] pWdfQueue

Penunjuk ke antarmuka IWDFIoQueue untuk objek antrean I/O tempat permintaan datang.

[in] pWdfRequest

Penunjuk ke antarmuka IWDFIoRequest yang mewakili objek permintaan kerangka kerja.

[in] ControlCode

Kode kontrol I/O yang ditentukan driver atau yang ditentukan sistem (IOCTL) yang mengidentifikasi operasi tertentu yang akan dilakukan dan yang terkait dengan permintaan.

InputBufferSizeInBytes

Ukuran, dalam byte, dari buffer input untuk permintaan.

OutputBufferSizeInBytes

Ukuran, dalam byte, dari buffer output untuk permintaan.

Nilai kembali

Tidak ada

Keterangan

Driver mendaftarkan antarmuka IQueueCallbackDeviceIoControl saat driver memanggil metode IWDFDevice::CreateIoQueue untuk membuat antrean I/O atau untuk mengonfigurasi antrean I/O default.

Driver dapat menerapkan satu metode OnDeviceIoControl untuk semua antrean I/O atau metode OnDeviceIoControl terpisah untuk setiap antrean I/O.

Metode OnDeviceIoControl menerima setiap jenis permintaan kontrol I/O perangkat dari antrean. (Jenis permintaan diidentifikasi oleh nilai WdfRequestDeviceIoControl dari jenis enumerasi WDF_REQUEST_TYPE untuk permintaan tersebut.)

Untuk informasi selengkapnya tentang metode driver yang terkait dengan antrean dan bahwa panggilan kerangka kerja, lihat Fungsi Panggilan Balik Peristiwa Antrean I/O. Metode OnDeviceIoControl harus memproses setiap permintaan kontrol I/O perangkat yang diterima. Untuk informasi selengkapnya tentang cara driver UMDF memproses permintaan I/O, lihat Memproses Permintaan I/O.

Driver dapat memanggil metode IWDFIoRequest::GetDeviceIoControlParameters, IWDFIoRequest::GetInputMemory, dan IWDFIoRequest::GetOutputMemory untuk mengambil informasi tentang permintaan dan buffer input dan output.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	wudfddi.h (termasuk Wudfddi.h)

Share via