EXPAND_STACK_CALLOUT fungsi panggilan balik (ntddk.h)
Rutinitas ExpandedStackCall dijalankan dengan ukuran tumpukan yang dijamin.
Sintaks
EXPAND_STACK_CALLOUT ExpandStackCallout;
VOID() ExpandStackCallout(
[in, optional] PVOID Parameter
)
{...}
Parameter
[in, optional] Parameter
Nilai yang diteruskan ke rutinitas KeExpandKernelStackAndCallout yang menjalankan ExpandedStackCall.
Nilai kembali
Tidak ada
Keterangan
Rutinitas ExpandedStackCall harus menangani semua pengecualian. Pengecualian yang tidak tertangani menyebabkan sistem memeriksa bug dengan 0x1E Pemeriksaan Bug: KMODE_EXCEPTION_NOT_HANDLED.
Jika ExpandedStackCall mengubah IRQL saat ini, itu harus memulihkan nilai asli sebelum mengembalikan.
Contoh
Untuk menentukan rutinitas panggilan balik ExpandedStackCall , 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 ExpandedStackCall yang diberi nama MyExpandedStackCall
, gunakan jenis EXPAND_STACK_CALLOUT seperti yang ditunjukkan dalam contoh kode ini:
EXPAND_STACK_CALLOUT MyExpandedStackCall;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
VOID
MyExpandedStackCall(
PVOID Parameter
)
{
// Function body
}
Jenis fungsi EXPAND_STACK_CALLOUT 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 EXPAND_STACK_CALLOUT 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 | ntddk.h (termasuk Ntddk.h, Ntifs.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk