PEP_KERNEL_INFORMATION_STRUCT_V2 結構 (pep_x.h)
PEP_KERNEL_INFORMATION 結構會指定 POWER Extension 外掛程式 (PEP) 用來向 Windows 電源管理架構要求服務的介面, (PoFx) 。
語法
typedef struct _PEP_KERNEL_INFORMATION_STRUCT_V2 {
USHORT Version;
USHORT Size;
POHANDLE Plugin;
PPOFXCALLBACKREQUESTWORKER RequestWorker;
PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
PPOFXCALLBACKPROCESSORHALT ProcessorHalt;
PPOFXCALLBACKREQUESTINTERRUPT RequestInterrupt;
PPOFXCALLBACKCRITICALRESOURCE TransitionCriticalResource;
PPOFXCALLBACKPROCESSORIDLEVETO ProcessorIdleVeto;
PPOFXCALLBACKPLATFORMIDLEVETO PlatformIdleVeto;
PPOFXCALLBACKUPDATEPROCESSORIDLESTATE UpdateProcessorIdleState;
PPOFXCALLBACKUPDATEPLATFORMIDLESTATE UpdatePlatformIdleState;
} PEP_KERNEL_INFORMATION_STRUCT_V2, *PPEP_KERNEL_INFORMATION_STRUCT_V2;
成員
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 會呼叫這個例程來更新指定平台閑置狀態的屬性。
備註
PoFxRegisterPlugin 或PoFxRegisterPluginEx 例程的 KernelInformation 參數是PEP_KERNEL_INFORMATION結構的指標。 PEP 會配置此結構,並在呼叫 PoFxRegisterPlugin 或 PoFxRegisterPluginEx 之前,先設定此結構的 Version 和 Size 成員的值。 在呼叫這個例程期間,PoFx 會填入結構的其餘成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從Windows 10 開始支援。 |
標頭 | pep_x.h |