Fungsi panggilan balik POFXCALLBACKPLATFORMIDLEVETO (pepfx.h)

Artikel
02/26/2024

PlatformIdleVeto secara rutin menaikkan atau mengurangi jumlah veto untuk kode veto untuk status diam platform.

Sintaks

POFXCALLBACKPLATFORMIDLEVETO Pofxcallbackplatformidleveto;

NTSTATUS Pofxcallbackplatformidleveto(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] ULONG VetoReason,
  [in] BOOLEAN Increment
)
{...}

Parameter

[in] ProcessorHandle

Nilai POHANDLE yang mewakili pendaftaran prosesor (sebagai perangkat) dengan kerangka kerja manajemen daya (PoFx). Plug-in ekstensi platform (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 status diam platform yang jumlah vetonya sedang bertambah atau berkurang. PEP sebelumnya menentukan status diam platform yang didukung sebagai respons terhadap pemberitahuan PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES . Jika PEP menentukan status diam platform N, indeks status diam platform yang valid berkisar dari 0 hingga N–1.

[in] VetoReason

Kode veto yang ditentukan PEP yang menunjukkan mengapa status diam platform tidak dapat dimasukkan. PEP sebelumnya menentukan jumlah alasan veto yang didukung sebagai respons terhadap pemberitahuan PEP_NOTIFY_PPM_QUERY_VETO_REASONS . Jika PEP menentukan alasan veto M, kode veto yang valid berkisar dari 1 hingga M.

[in] Increment

Apakah akan menambah atau mengurangi jumlah veto. Atur ke TRUE untuk menambah jumlah veto karena alasan veto ini, atau ke FALSE untuk mengurangi hitungan.

Menampilkan nilai

PlatformIdleVeto mengembalikan STATUS_SUCCESS jika panggilan berhasil bertambah atau mengurangi jumlah veto. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Mengembalikan nilai	Deskripsi
STATUS_NOT_IMPLEMENTED	Menunjukkan bahwa rutinitas PlatformIdleVeto tidak diimplementasikan untuk prosesor ini.

Keterangan

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

Setelah PEP menangani pemberitahuan PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES , setiap status diam platform dimulai dengan jumlah veto nol untuk semua kode veto. PEP dapat meningkatkan jumlah veto kode veto untuk mencegah sistem operasi transisi platform ke status menganggur ini. PEP mengurangi jumlah veto ketika alasan veto yang menyebabkan hitungan bertambah bertahap tidak lagi berlaku. Hanya setelah hitungan untuk semua kode veto telah berkurang menjadi nol adalah sistem operasi yang diizinkan untuk transisi platform ke status menganggur ini.

Rutinitas ini harus dipanggil di IRQL = PASSIVE_LEVEL.