PEP_KERNEL_INFORMATION_STRUCT_V1 結構 (pep_x.h)

  • 發行項

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

語法

typedef struct _PEP_KERNEL_INFORMATION_STRUCT_V1 {
  USHORT                                   Version;
  USHORT                                   Size;
  POHANDLE                                 Plugin;
  PPOFXCALLBACKREQUESTWORKER               RequestWorker;
  PPOFXCALLBACKENUMERATEUNMASKEDINTERRUPTS EnumerateUnmaskedInterrupts;
  PPOFXCALLBACKPROCESSORHALT               ProcessorHalt;
  PPOFXCALLBACKREQUESTINTERRUPT            RequestInterrupt;
  PPOFXCALLBACKCRITICALRESOURCE            TransitionCriticalResource;
} PEP_KERNEL_INFORMATION_STRUCT_V1, *PPEP_KERNEL_INFORMATION_STRUCT_V1;

成員

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 會呼叫此例程，將重要的系統資源轉換為閑置狀況。

備註

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

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
標頭 pep_x.h

另請參閱