enumerasi WDF_EXECUTION_LEVEL (wdfobject.h)

Artikel
06/01/2023

[Berlaku untuk KMDF dan UMDF]

Jenis enumerasi WDF_EXECUTION_LEVEL menentukan IRQL maksimum di mana kerangka kerja akan memanggil fungsi panggilan balik peristiwa yang telah disediakan driver untuk objek kerangka kerja.

Sintaks

typedef enum _WDF_EXECUTION_LEVEL {
  WdfExecutionLevelInvalid = 0x00,
  WdfExecutionLevelInheritFromParent,
  WdfExecutionLevelPassive,
  WdfExecutionLevelDispatch
} WDF_EXECUTION_LEVEL;

Konstanta


`WdfExecutionLevelInvalid` Nilai: 0x00 Dicadangkan untuk penggunaan sistem.
`WdfExecutionLevelInheritFromParent` Kerangka kerja menggunakan nilai IRQL maksimum induk objek, kecuali objek adalah yang memerlukan IRQL = DISPATCH_LEVEL (seperti objek DPC). Nilai ini adalah default jika driver tidak menentukan nilai yang WDF_EXECUTION_LEVEL ketik.
`WdfExecutionLevelPassive` Kerangka kerja selalu memanggil fungsi panggilan balik objek di IRQL = PASSIVE_LEVEL.
`WdfExecutionLevelDispatch` Kerangka kerja memanggil fungsi panggilan balik objek di IRQL <= DISPATCH_LEVEL. Tidak tersedia di UMDF.

Keterangan

Driver menggunakan jenis enumerasi WDF_EXECUTION_LEVEL untuk menentukan anggota ExecutionLevel dari struktur WDF_OBJECT_ATTRIBUTES objek.

Anda dapat menentukan nilai ExecutionLevel untuk objek berikut:

Objek driver kerangka kerja
Objek perangkat kerangka kerja
Objek file kerangka kerja
Objek umum kerangka kerja
Objek antrean kerangka kerja (Framework versi 1.9 dan yang lebih baru)
Objek timer kerangka kerja (Framework versi 1.9 dan yang lebih baru)

KMDF Secara default, kerangka kerja menetapkan nilai ExecutionLevel objek driver kerangka kerja ke WdfExecutionLevelDispatch.

UMDF Secara default, kerangka kerja menetapkan nilai ExecutionLevel objek driver kerangka kerja ke WdfExecutionLevelPassive.

Nilai ExecutionLevel default untuk semua objek lainnya adalah WdfExecutionLevelInheritFromParent.

Untuk informasi selengkapnya tentang tingkat eksekusi untuk fungsi panggilan balik peristiwa, lihat Teknik Sinkronisasi untuk Driver Framework-Based.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfobject.h (termasuk Wdf.h)

Lihat juga

WDF_OBJECT_ATTRIBUTES

Bagikan melalui