Fungsi panggilan balik POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pepfx.h)

Artikel
02/29/2024

Rutinitas EnumerateUnmaskedInterrupts menghitung sumber interupsi yang interupsinya dibuka kedoknya dan diaktifkan.

Sintaks

POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS Pofxcallbackenumerateunmaskedinterrupts;

NTSTATUS Pofxcallbackenumerateunmaskedinterrupts(
  [in, optional] POHANDLE PluginHandle,
  [in, optional] ULONG EnumerateFlags,
  [in]           PPO_ENUMERATE_INTERRUPT_SOURCE_CALLBACK Callback,
  [in]           PVOID CallbackContext,
  [in, out]      PPEP_UNMASKED_INTERRUPT_INFORMATION InterruptInformation
)
{...}

Parameter

[in, optional] PluginHandle

Nilai POHANDLE. Jika non-NULL, parameter ini adalah handel yang mengidentifikasi plug-in ekstensi platform (PEP), dalam hal ini EnumerateUnmaskedInterrupts hanya menghitung gangguan yang dikelola oleh PEP ini. Jika parameter ini ADALAH NULL, EnumerateUnmaskedInterrupts menghitung semua interupsi di platform perangkat keras yang dibuka kemasannya dan diaktifkan.

[in, optional] EnumerateFlags

Tidak ada bendera yang saat ini ditentukan. Atur parameter ini ke PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0).

[in] Callback

Penunjuk ke rutinitas panggilan balik EnumerateInterruptSource yang diimplementasikan penelepon. Rutinitas panggilan balik ini dipanggil sekali untuk setiap sumber interupsi yang interupsinya tidak dikemas. Panggilan balik ini terjadi secara sinkron sebelum pengembalian rutin EnumerateUnmaskedInterrupts .

[in] CallbackContext

Penunjuk ke konteks panggilan balik. Pointer ini diteruskan sebagai parameter ke rutinitas callback EnumerateInterruptSource yang diarahkan oleh parameter Callback . Konten konteks panggilan balik ditentukan PEP, dan buram untuk kerangka kerja manajemen daya (PoFx).

[in, out] InterruptInformation

Penunjuk ke buffer yang dialokasikan penelepon yang ukurannya setidaknya sizeof(PEP_UNMASKED_INTERRUPT_INFORMATION) byte. EnumerateUnmaskedInterrupts akan menggunakan buffer ini untuk mentransfer informasi interupsi ke PEP selama panggilan ke rutinitas panggilan balik EnumerateInterruptSource PEP.

Nilai kembali

EnumerateUnmaskedInterrupts mengembalikan STATUS_SUCCESS jika panggilan berhasil menghitung interupsi. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Mengembalikan nilai	Deskripsi
STATUS_INVALID_PARAMETER	Anggota Ukuran atau Versi dari struktur PEP_UNMASKED_INTERRUPT_INFORMATION berisi nilai yang tidak valid.

Keterangan

Rutinitas ini diimplementasikan oleh PoFx dan dipanggil oleh PEP. Anggota EnumerateUnmaskedInterrupts dari struktur PEP_KERNEL_INFORMATION_STRUCT_V3 adalah penunjuk ke rutinitas EnumerateUnmaskedInterrupts .

Sebelum platform memasuki status daya sistem di mana pengontrol interupsi berpagar daya, PEP dapat memanggil EnumerateUnmaskedInterrupts untuk mendapatkan informasi yang diperlukan untuk mengonfigurasi pengontrol bangun dengan benar untuk gangguan yang tetap terbuka.

PEP dapat memanggil rutinitas ini di IRQL <= HIGH_LEVEL.