EVT_WDF_IO_QUEUE_IO_DEFAULT fungsi panggilan balik (wdfio.h)

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtIoDefault driver memproses permintaan I/O tertentu.

Sintaks

EVT_WDF_IO_QUEUE_IO_DEFAULT EvtWdfIoQueueIoDefault;

void EvtWdfIoQueueIoDefault(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request
)
{...}

Parameter

[in] Queue

Handel ke objek antrean kerangka kerja yang terkait dengan permintaan I/O.

[in] Request

Handel ke objek permintaan kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

Driver mendaftarkan fungsi panggilan balik EvtIoDefault saat memanggil WdfIoQueueCreate. Untuk informasi selengkapnya tentang memanggil WdfIoQueueCreate, lihat Membuat Antrean I/O.

Jika driver telah mendaftarkan fungsi panggilan balik EvtIoDefault untuk antrean I/O perangkat, fungsi panggilan balik menerima setiap permintaan I/O dari antrean, kecuali fungsi panggilan balik khusus permintaan juga telah terdaftar. Untuk informasi selengkapnya tentang fungsi panggilan balik khusus permintaan, lihat Penangan Permintaan.

Fungsi panggilan balik EvtIoDefault driver juga dapat menerima permintaan pembuatan file. Untuk informasi selengkapnya tentang menerima permintaan pembuatan file, lihat Objek File Kerangka Kerja.

Fungsi panggilan balik EvtIoDefault harus memproses setiap permintaan I/O yang diterima dengan cara tertentu. Untuk informasi selengkapnya, lihat Memproses Permintaan I/O.

Sebagian besar operasi I/O memerlukan buffer input, buffer output, atau keduanya. Untuk informasi tentang bagaimana driver dapat mengakses buffer permintaan, lihat Mengakses Buffer Data di driver Framework-Based.

Fungsi panggilan balik ini dapat dipanggil di IRQL <= DISPATCH_LEVEL, kecuali anggota ExecutionLevel dari perangkat atau struktur WDF_OBJECT_ATTRIBUTES driver diatur ke WdfExecutionLevelPassive.

Jika IRQL PASSIVE_LEVEL, kerangka kerja memanggil fungsi panggilan balik dalam wilayah penting.

Untuk informasi selengkapnya tentang tingkat IRQL untuk penangan permintaan, lihat Menggunakan Sinkronisasi Otomatis.

Fungsi panggilan balik EvtIoDefault driver tidak boleh memanggil metode objek antrean berikut:

WdfIoQueueDrainSynchronously
WdfIoQueuePurgeSynchronously
WdfIoQueueStopSynchronously

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfio.h (termasuk Wdf.h)
IRQL <= DISPATCH_LEVEL (lihat bagian Keterangan)

Lihat juga

EvtIoDeviceControl

EvtIoInternalDeviceControl

EvtIoRead

EvtIoWrite

WDF_OBJECT_ATTRIBUTES

WdfIoQueueBuat