PEP_KERNEL_INFORMATION_STRUCT_V3構造体 (pepfx.h)

[アーティクル]
08/07/2023

PEP_KERNEL_INFORMATION_STRUCT_V3構造体は、電源拡張機能プラグイン (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 は構造体の残りのメンバーを入力します。