PEP_KERNEL_INFORMATION_STRUCT_V3 結構 (pepfx.h)

發行項
06/08/2024

PEP_KERNEL_INFORMATION_STRUCT_V3 結構會指定 power extension 外掛程式 (PEP) 用來向 Windows 電源管理架構要求服務的介面， (PoFx) 。

語法

typedef struct _PEP_KERNEL_INFORMATION_STRUCT_V3 {
  USHORT                                   Version;
  USHORT                                   Size;
  POHANDLE                                 Plugin;
  PPOFXCALLBACKREQUESTWORKER               RequestWorker;
  PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
  PPOFXCALLBACKPROCESSORHALT               ProcessorHalt;
  PPOFXCALLBACKREQUESTINTERRUPT            RequestInterrupt;
  PPOFXCALLBACKCRITICALRESOURCE            TransitionCriticalResource;
  PPOFXCALLBACKPROCESSORIDLEVETO           ProcessorIdleVeto;
  PPOFXCALLBACKPLATFORMIDLEVETO            PlatformIdleVeto;
  PPOFXCALLBACKUPDATEPROCESSORIDLESTATE    UpdateProcessorIdleState;
  PPOFXCALLBACKUPDATEPLATFORMIDLESTATE     UpdatePlatformIdleState;
  PPOFXCALLBACKREQUESTCOMMON               RequestCommon;
} PEP_KERNEL_INFORMATION_STRUCT_V3, *PPEP_KERNEL_INFORMATION_STRUCT_V3;

成員

Version

這個結構的目前版本號碼。將此成員設定為 PEP_KERNEL_INFORMATION_VERSION。

Size

這個結構的大小，以位元組為單位。將此成員設定為 sizeof (PEP_KERNEL_INFORMATION) 。

Plugin

指派給 PEP 向 PoFx 註冊的句柄。 PoFx 會設定這個成員的值。 PEP 會在對 RequestWorker 例程的呼叫中使用這個句柄。

RequestWorker

RequestWorker 例程的指標。 PoFx 會設定這個成員的值。 RequestWorker 例程是由 PoFx 實作。 PEP 會呼叫此例程，以要求從操作系統使用背景工作線程。

EnumerateUnmaskedInterrupts

EnumerateUnmaskedInterrupts 例程的指標。 PoFx 會設定這個成員的值。 EnumerateUnmaskedInterrupts 例程是由PoFx實作。 PEP 會呼叫此例程來要求未遮罩中斷的相關信息。

ProcessorHalt

ProcessorHalt 例程的指標。 PoFx 會設定這個成員的值。 ProcessorHalt 例程是由PoFx實作。 PEP 會呼叫此例程，以準備目前的處理器進入已停止的狀態。

RequestInterrupt

RequestInterrupt 例程的指標。 PoFx 會設定這個成員的值。 RequestInterrupt 例程是由 PoFx 實作。 PEP 會呼叫此例程，以重新執行在硬體平台進入低電源系統狀態之後可能遺失的邊緣觸發中斷。

TransitionCriticalResource

TransitionCriticalResource 例程的指標。 PoFx 會設定這個成員的值。 TransitionCriticalResource 例程是由 PoFx 實作。 PEP 會呼叫此例程，將重要的系統資源轉換為閑置狀況。

ProcessorIdleVeto

ProcessorIdleVeto 例程的指標。 PoFx 會設定這個成員的值。 ProcessorIdleVeto 例程是由 PoFx 實作。 PEP 會呼叫此例程來遞增或遞減暫止轉換至處理器閑置狀態的 veto 計數。

PlatformIdleVeto

PlatformIdleVeto 例程的指標。 PoFx 會設定這個成員的值。 PlatformIdleVeto 例程是由 PoFx 實作。 PEP 會呼叫此例程來遞增或遞減暫止轉換至平臺閑置狀態的 veto 計數。

UpdateProcessorIdleState

UpdateProcessorIdleState 例程的指標。 PoFx 會設定這個成員的值。 UpdateProcessorIdleState 例程是由 PoFx 實作。 PEP 會呼叫這個例程來更新指定處理器閑置狀態的屬性。

UpdatePlatformIdleState

UpdatePlatformIdleState 例程的指標。 PoFx 會設定這個成員的值。 UpdatePlatformIdleState 例程是由 PoFx 實作。 PEP 會呼叫這個例程來更新指定平台閑置狀態的屬性。

RequestCommon

RequestCommon 例程的指標。 PoFx 會設定這個成員的值。 RequestCommon 例程是由 PoFx 實作。 PEP 會呼叫這個例程來執行要求標識碼所指定的處理作業。

備註

PoFxRegisterPlugin 或 PoFxRegisterPluginEx 例程的 KernelInformation 參數是PEP_KERNEL_INFORMATION結構的指標。 PEP 會配置此結構，並在呼叫 PoFxRegisterPlugin 或 PoFxRegisterPluginEx 之前，先設定此結構的 Version 和 Size 成員的值。在呼叫這個例程期間，PoFx 會填入結構的其餘成員。