Fungsi panggilan balik POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)

Artikel
02/29/2024

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

Sintaks

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_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] PlatformState

Indeks yang mengidentifikasi status diam platform yang propertinya akan diperbarui. Menanggapi pemberitahuan PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES sebelumnya, PEP menentukan jumlah status diam platform yang didukung. Jika STATUS diam platform N yang ditentukan PEP, indeks status diam platform yang valid berkisar antara 0 hingga N-1. Menanggapi pemberitahuan PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE sebelumnya, PEP menentukan properti status menganggur platform ini.

[in] Update

Penunjuk ke struktur PEP_PLATFORM_IDLE_STATE_UPDATE yang berisi properti yang diperbarui dari status diam platform.

Menampilkan nilai

UpdatePlatformIdleState mengembalikan STATUS_SUCCESS jika berhasil memperbarui properti status diam platform. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

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

Keterangan

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

PEP harus menunggu sampai setelah menyelesaikan semua pemberitahuan PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE untuk memanggil rutinitas UpdatePlatformIdleState .

Rutinitas UpdatePlatformIdleState harus dipanggil di IRQL = PASSIVE_LEVEL.