Fungsi panggilan balik POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)

Rutinitas UpdatePlatformIdleState dipanggil oleh plug-in ekstensi platform (PEP) untuk memperbarui properti status idle 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 dari 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.

Mengembalikan nilai

UpdatePlatformIdleState mengembalikan STATUS_SUCCESS jika berhasil memperbarui properti status diam platform. Kemungkinan nilai pengembalian kesalahan menyertakan 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.

Persyaratan

   
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Target Platform Windows
Header pepfx.h (termasuk Pep_x.h)
IRQL PASSIVE_LEVEL

Lihat juga

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE