EVT_WDF_INTERRUPT_SYNCHRONIZE fungsi panggilan balik (wdfinterrupt.h)

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtInterruptSynchronize driver melakukan operasi yang harus disinkronkan dengan fungsi panggilan balik EvtInterruptIsr .

Sintaks

EVT_WDF_INTERRUPT_SYNCHRONIZE EvtWdfInterruptSynchronize;

BOOLEAN EvtWdfInterruptSynchronize(
  [in] WDFINTERRUPT Interrupt,
  [in] WDFCONTEXT Context
)
{...}

Parameter

[in] Interrupt

Handel ke objek interupsi kerangka kerja.

[in] Context

Informasi yang disediakan driver yang ditentukan driver ketika memanggil WdfInterruptSynchronize.

Nilai kembali

Fungsi panggilan balik EvtInterruptSynchronize harus mengembalikan TRUE jika operasi berhasil. Jika tidak, fungsi ini harus mengembalikan FALSE.

Keterangan

Untuk menjalankan fungsi panggilan balik EvtInterruptSynchronize , driver harus memanggil WdfInterruptSynchronize.

Jika driver telah mengonfigurasi objek interupsi untuk penanganan di IRQL perangkat (DIRQL), maka sebelum memanggil fungsi panggilan balik EvtInterruptSynchronize , kerangka kerja menaikkan tingkat permintaan interupsi prosesor ke DIRQL dan memperoleh kunci putar yang ditentukan driver dalam struktur WDF_INTERRUPT_CONFIG objek interupsi.

Akibatnya, sementara fungsi panggilan balik EvtInterruptSynchronize dijalankan, fungsi panggilan balik EvtInterruptIsr objek interupsi (dan kode lain yang dijalankan di DIRQL sambil menahan kunci putar) tidak dapat dijalankan.

Fungsi panggilan balik EvtInterruptSynchronize harus dirancang sehingga dijalankan hanya dalam waktu singkat. Mereka biasanya digunakan untuk mengakses data interupsi yang juga diakses oleh fungsi panggilan balik EvtInterruptSynchronize atau EvtInterruptIsr lainnya.

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

Untuk informasi selengkapnya tentang fungsi panggilan balik EvtInterruptSynchronize , lihat Menyinkronkan Kode Interupsi.

Untuk informasi selengkapnya tentang penanganan 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

EvtInterruptIsr

WDF_INTERRUPT_CONFIG

WdfInterruptSynchronize