EVT_WDF_INTERRUPT_ENABLE fungsi panggilan balik (wdfinterrupt.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtInterruptEnable driver memungkinkan gangguan perangkat keras tertentu.

Sintaks

EVT_WDF_INTERRUPT_ENABLE EvtWdfInterruptEnable;

NTSTATUS EvtWdfInterruptEnable(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFDEVICE AssociatedDevice
)
{...}

Parameter

[in] Interrupt

Handel ke objek interupsi kerangka kerja.

[in] AssociatedDevice

Handel ke objek perangkat kerangka kerja yang diteruskan driver ke WdfInterruptCreate.

Nilai kembali

Fungsi panggilan balik EvtInterruptEnable harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE jika fungsi tidak mengalami kesalahan. Jika tidak, fungsi ini harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtInterruptEnable , driver Anda harus menempatkan alamat fungsi panggilan balik dalam struktur WDF_INTERRUPT_CONFIG sebelum memanggil WdfInterruptCreate.

Kerangka kerja memanggil fungsi panggilan balik EvtInterruptEnable driver setiap kali perangkat memasuki status berfungsi (D0). Selain itu, driver dapat menyebabkan kerangka kerja memanggil fungsi panggilan balik EvtInterruptEnable dengan memanggil WdfInterruptEnable. Perhatikan bahwa sebagian besar driver berbasis kerangka kerja tidak boleh memanggil WdfInterruptEnable, karena kerangka kerja memanggil fungsi panggilan balik EvtInterruptEnable driver setiap kali perangkat memasuki status berfungsi (D0).

Sebelum memanggil fungsi panggilan balik EvtInterruptEnable , kerangka kerja menaikkan IRQL prosesor ke DIRQL perangkat dan memperoleh kunci spin yang ditentukan driver dalam struktur WDF_INTERRUPT_CONFIG objek interupsi.

Dimulai dengan KMDF versi 1.11, driver Anda dapat memberikan penanganan gangguan tingkat pasif. Jika driver telah meminta penanganan gangguan tingkat pasif, maka sebelum memanggil fungsi EvtInterruptEnable di IRQL = PASSIVE_LEVEL, kerangka kerja memperoleh kunci gangguan tingkat pasif yang dikonfigurasi driver dalam struktur WDF_INTERRUPT_CONFIG objek interupsi.

Setelah fungsi panggilan balik EvtInterruptEnable kembali, kerangka kerja memanggil fungsi panggilan balik peristiwa EvtDeviceD0EntryPostInterruptsEnabled driver di IRQL = PASSIVE_LEVEL.

Anda tidak boleh berasumsi bahwa perangkat akan menggunakan sumber daya interupsi yang sama setiap kali kerangka kerja memanggil fungsi panggilan balik EvtInterruptEnable driver Anda. Terkadang manajer PnP mendistribusikan ulang sumber daya sistem, dan mungkin menetapkan sumber daya interupsi baru ke perangkat Anda. Driver dapat memanggil WdfInterruptGetInfo untuk menentukan sumber daya interupsi perangkat.

Untuk informasi selengkapnya tentang menangani gangguan dalam driver berbasis kerangka kerja, lihat Menangani Gangguan Perangkat Keras.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfinterrupt.h (termasuk Wdf.h)
IRQL	(Lihat bagian Keterangan.)