EVT_WDF_INTERRUPT_DISABLE fungsi panggilan balik (wdfinterrupt.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtInterruptDisable driver menonaktifkan gangguan perangkat keras tertentu.

Sintaks

EVT_WDF_INTERRUPT_DISABLE EvtWdfInterruptDisable;

NTSTATUS EvtWdfInterruptDisable(
  [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 EvtInterruptDisable 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 EvtInterruptDisable , driver Anda harus menempatkan alamat fungsi panggilan balik dalam struktur WDF_INTERRUPT_CONFIG sebelum memanggil WdfInterruptCreate.

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

Sebelum memanggil fungsi panggilan balik EvtInterruptDisable , 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 EvtInterruptDisable di IRQL = PASSIVE_LEVEL, kerangka kerja memperoleh kunci interupsi tingkat pasif yang dikonfigurasi driver dalam struktur WDF_INTERRUPT_CONFIG objek interupsi.

Sebelum memanggil fungsi panggilan balik EvtInterruptDisable , kerangka kerja memanggil fungsi panggilan balik peristiwa EvtDeviceD0ExitPreInterruptsDisabled driver di IRQL = PASSIVE_LEVEL.

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.)

Lihat juga

EvtDeviceD0ExitPreInterruptsDisabled