PEP_KERNEL_INFORMATION_STRUCT_V3 構造体 (pep_x.h)
PEP_KERNEL_INFORMATION構造体は、電源拡張機能プラグイン (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
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 は、このルーチンを呼び出して、指定されたプラットフォームのアイドル状態のプロパティを更新します。
RequestCommon
RequestCommon ルーチンへのポインター。 PoFx は、このメンバーの値を設定します。 RequestCommon ルーチンは PoFx によって実装されます。 PEP はこのルーチンを呼び出して、要求 ID で指定された処理操作を実行します。
注釈
PoFxRegisterPlugin ルーチンまたは PoFxRegisterPluginEx ルーチンへの KernelInformation パラメーターは、PEP_KERNEL_INFORMATION構造体へのポインターです。 PEP は、PoFxRegisterPlugin または PoFxRegisterPluginEx を呼び出す前に、この構造体を割り当て、この構造体の Version メンバーと Size メンバーの値を設定します。 このルーチンの呼び出し中に、PoFx は構造体の残りのメンバーを入力します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 以降でサポートされています。 |
| Header | pep_x.h |