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

設定為零。 ExInitializeSetTimerParameters 例程會將這個成員設定為零。

NoWakeTolerance

時間上限，以系統時間單位 (100 奈秒間隔) ，定時器可以在定時器到達其到期時間之後等候喚醒處理器。 只有在處理器喚醒之後，定時器才會過期。 如果定時器設定為在處理器處於低電源狀態時到期，定時器將不會喚醒處理器到期，直到到期時間加上 NoWakeTolerance 延遲超過為止。 作為選項，驅動程式可以將此成員設定為 EX_TIMER_UNLIMITED_TOLERANCE，這表示定時器永遠不會喚醒處理器，因此，除非處理器因其他原因而喚醒，否則無法過期。

請勿將此成員設定為負值， (EX_TIMER_UNLIMITED_TOLERANCE) 以外的值。 否則，例程 Bug 會檢查。

備註

ExSetTimer 例程的 Parameters 參數是EXT_SET_PARAMETERS 結構的指標。 將 EXT_SET_PARAMETERS 結構傳遞至這個例程之前，請先呼叫 ExInitializeSetTimerParameters 例程來初始化結構。

ExInitializeSetTimerParameters 例程會將 NoWakeTolerance 成員設定為零，這表示當處理器處於低電量狀態時，定時器會立即喚醒處理器。 若要減少耗電量，驅動程式可以將此成員設定為非零值，以延長處理器花費在低電量狀態的時間。

規格需求

另請參閱

ExInitializeSetTimerParameters

ExSetTimer