KIPI_BROADCAST_WORKER fungsi panggilan balik (wdm.h)

Rutinitas IpiGenericCall berjalan secara bersamaan pada semua prosesor.

Sintaks

KIPI_BROADCAST_WORKER KipiBroadcastWorker;

ULONG_PTR KipiBroadcastWorker(
  [in] ULONG_PTR Argument
)
{...}

Parameter

[in] Argument

Memasok nilai yang diteruskan ke rutinitas KeIpiGenericCall yang disebut IpiGenericCall.

Mengembalikan nilai

IpiGenericCall mengembalikan nilai yang ditentukan driver. Jika IpiGenericCall berjalan pada prosesor yang sama dengan yang disebut KeIpiGenericCall, KeIpiGenericCall mengembalikan nilai yang ditentukan driver yang dikembalikan IpiGenericCall . Jika tidak, nilai diabaikan.

Keterangan

Rutinitas IpiGenericCall berjalan di IRQL = IPI_LEVEL, yang lebih besar dari DIRQL untuk setiap perangkat. Rutinitas IpiGenericCall harus memenuhi batasan yang sama dengan rutinitas panggilan balik pemeriksaan bug. Untuk informasi selengkapnya tentang pembatasan ini, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug.

Contoh

Untuk menentukan rutinitas panggilan balik IpiGenericCall , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk pengandar. 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 IpiGenericCall yang diberi nama MyIpiGenericCall, gunakan jenis KIPI_BROADCAST_WORKER seperti yang ditunjukkan dalam contoh kode ini:

KIPI_BROADCAST_WORKER MyIpiGenericCall;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
ULONG_PTR
  MyIpiGenericCall(
    ULONG_PTR  Argument
    )
  {
      // Function body
  }

Jenis fungsi KIPI_BROADCAST_WORKER ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi Use_decl_annotations ke definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi KIPI_BROADCAST_WORKER 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 Perilaku Fungsi Anotasi.

Persyaratan

   
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL Dipanggil pada IPI_LEVEL.

Lihat juga

KeipiGenericCall