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

こちらもご覧ください