KSYNCHRONIZE_ROUTINE fungsi panggilan balik (wdm.h)

Rutinitas SynchCritSection digunakan untuk mengakses sumber daya perangkat keras atau data driver yang dibagikan dengan rutinitas InterruptService driver.

Sintaks

KSYNCHRONIZE_ROUTINE KsynchronizeRoutine;

BOOLEAN KsynchronizeRoutine(
  [in] PVOID SynchronizeContext
)
{...}

Parameter

[in] SynchronizeContext

Informasi konteks yang disediakan pemanggil, ditentukan oleh panggilan driver ke KeSynchronizeExecution.

Nilai kembali

Jika operasi rutin berhasil, rutinitas harus mengembalikan TRUE; jika tidak, itu harus mengembalikan FALSE. (Keberhasilan dan kegagalan rutinitas ini ditentukan driver.) Nilai pengembalian yang ditentukan menjadi nilai pengembalian untuk KeSynchronizeExecution.

Keterangan

Driver harus menggunakan rutinitas SynchCritSection untuk mengakses sumber daya perangkat keras atau data driver yang juga dapat diakses oleh rutinitas InterruptService (ISR).

Sistem memanggil rutinitas SynchCritSection driver ketika driver memanggil KeSynchronizeExecution. Ketika driver memanggil KeSynchronizeExecution, driver menentukan alamat rutinitas SynchCritSection , informasi konteks untuk rutinitas, dan penunjuk objek interupsi. Rutinitas KeSynchronizeExecution memperoleh kunci putar objek interupsi, lalu memanggil rutinitas SynchCritSection .

Rutinitas SynchCritSection driver dijalankan pada IRQL yang sama dengan ISR yang terkait dengannya. Secara khusus, ini dijalankan di beberapa DIRQL yang ditetapkan sistem, seperti yang ditentukan oleh parameter SynchronizeIrql ke IoConnectInterrupt. (Perangkat lain, dengan nilai DIRQL yang lebih tinggi, dapat mengganggu rutinitas SynchCritSection .)

Contoh

Untuk menentukan rutinitas panggilan balik SynchCritSection , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk driver. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan rutinitas panggilan balik SynchCritSection yang diberi nama MySynchCritSection, gunakan jenis KSYNCHRONIZE_ROUTINE seperti yang ditunjukkan dalam contoh kode ini:

KSYNCHRONIZE_ROUTINE MySynchCritSection;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
BOOLEAN
  MySynchCritSection(
    PVOID  SynchronizeContext
    )
  {
      // Function body
  }

Jenis fungsi KSYNCHRONIZE_ROUTINE didefinisikan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan _Use_decl_annotations_ anotasi ke definisi fungsi Anda. Anotasi _Use_decl_annotations_ memastikan bahwa anotasi yang diterapkan ke jenis fungsi KSYNCHRONIZE_ROUTINE dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang _Use_decl_annotations_, lihat Menganotasi Perilaku Fungsi.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Dipanggil di DIRQL (lihat bagian Keterangan).