PEP_KERNEL_INFORMATION_STRUCT_V2構造体 (pep_x.h)
PEP_KERNEL_INFORMATION構造体は、電源拡張機能プラグイン (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
PoFx に対する PEP の登録に割り当てられたハンドル。 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 は、このルーチンを呼び出して、保留中のプロセッサアイドル状態への遷移の拒否カウントをインクリメントまたはデクリメントします。
PlatformIdleVeto
PlatformIdleVeto ルーチンへのポインター。 PoFx は、このメンバーの値を設定します。 PlatformIdleVeto ルーチンは、PoFx によって実装されます。 PEP は、このルーチンを呼び出して、プラットフォームアイドル状態への保留中の遷移の拒否カウントをインクリメントまたはデクリメントします。
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 以降でサポートされています。 |
| Header | pep_x.h |