Share via

enumerasi WDF_EXECUTION_LEVEL (wdfobject.h)

  • Artikel

[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