EXT_SET_PARAMETERS 構造体 (wdm.h)

  • [アーティクル]

EXT_SET_PARAMETERS構造体には、ExSetTimer ルーチンの拡張パラメーター セットが含まれています。

構文

typedef struct _EXT_SET_PARAMETERS_V0 {
  ULONG    Version;
  ULONG    Reserved;
  LONGLONG NoWakeTolerance;
} EXT_SET_PARAMETERS, *PEXT_SET_PARAMETERS;

メンバー

Version

この EXT_SET_PARAMETERS 構造体のバージョン番号。 ExInitializeSetTimerParameters ルーチンは、このメンバーを正しいバージョン番号に設定します。

Reserved

0 に設定します。 ExInitializeSetTimerParameters ルーチンは、このメンバーを 0 に設定します。

NoWakeTolerance

タイマーが有効期限に達した後、タイマーがプロセッサのスリープ解除を待機できる最大時間 (システム時間単位 (100 ナノ秒間隔)。 プロセッサのスリープ解除後にのみ、タイマーの有効期限が切れます。 プロセッサが低電力状態のときにタイマーが期限切れに設定されている場合、タイマーは、有効期限と NoWakeTolerance 遅延を超えるまで、プロセッサをスリープ解除しません。 オプションとして、ドライバーは、このメンバーを EX_TIMER_UNLIMITED_TOLERANCE に設定できます。これは、タイマーがプロセッサをスリープ解除せず、プロセッサが何らかの理由でスリープ解除するまで期限切れになることができないことを示します。

このメンバーを負の値 (EX_TIMER_UNLIMITED_TOLERANCE以外) に設定しないでください。 それ以外の場合は、ルーチンのバグチェックが行われます。

注釈

ExSetTimer ルーチンの Parameters パラメーターは、EXT_SET_PARAMETERS構造体へのポインターです。 このルーチンにEXT_SET_PARAMETERS構造体を渡す前に、ExInitializeSetTimerParameters ルーチンを呼び出して構造体を初期化します。

ExInitializeSetTimerParameters ルーチンは NoWakeTolerance メンバーを 0 に設定します。つまり、プロセッサが低電力状態のときにタイマーが有効期限に達すると、タイマーは直ちにプロセッサをスリープ解除します。 電力消費を減らすために、ドライバーは、プロセッサが低電力状態で費やす時間を延長する 0 以外の値にこのメンバーを設定できます。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 以降でサポートされます。
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

ExInitializeSetTimerParameters

ExSetTimer