Fungsi panggilan balik POFXCALLBACKUPDATEPROCESSORIDLESTATE (pepfx.h)

Artikel
08/07/2023

Rutinitas UpdateProcessorIdleState dipanggil oleh plug-in ekstensi platform (PEP) untuk memperbarui properti status menganggur prosesor yang ditentukan.

Sintaks

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

Parameter

[in] ProcessorHandle

Nilai POHANDLE yang mewakili pendaftaran prosesor (sebagai perangkat) dengan kerangka kerja manajemen daya Windows (PoFx). PEP sebelumnya menerima handel ini dari PoFx selama pemberitahuan PEP_DPM_REGISTER_DEVICE yang memberi tahu PEP bahwa prosesor telah terdaftar di PoFx.

[in] ProcessorState

Indeks yang mengidentifikasi status menganggur prosesor yang propertinya akan diperbarui. Menanggapi pemberitahuan PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 sebelumnya, PEP menentukan jumlah status menganggur prosesor yang didukung dan properti status ini. Jika status menganggur prosesor N yang ditentukan PEP, indeks status menganggur prosesor yang valid berkisar antara 0 hingga N-1.

[in] Update

Penunjuk ke struktur PEP_PROCESSOR_IDLE_STATE_UPDATE yang berisi properti status menganggur prosesor yang diperbarui.

Menampilkan nilai

UpdateProcessorIdleState mengembalikan STATUS_SUCCESS jika berhasil memperbarui properti status menganggur prosesor. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Mengembalikan nilai	Deskripsi
STATUS_NOT_SUPPORTED	Nomor versi dalam struktur PEP_PROCESSOR_IDLE_STATE_UPDATE bukan nilai yang didukung.
STATUS_NOT_IMPLEMENTED	Rutinitas UpdateProcessorIdleState tidak diimplementasikan untuk prosesor ini.

Keterangan

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

Rutinitas UpdateProcessorIdleState harus dipanggil di IRQL = PASSIVE_LEVEL.