共用方式為


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以外的值)。 否則,例程錯誤會檢查。

言論

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

ExInitializeSetTimerParameters 例程會將 NoWakeTolerance 成員設為零,這表示如果定時器達到處理器處於低功率狀態的到期時間,定時器就會立即喚醒處理器。 為了降低耗電量,驅動程式可以將這個成員設定為非零值,以延長處理器花費在低功率狀態的時間。

要求

要求 價值
最低支援的用戶端 從 Windows 8.1 開始支援。
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

ExInitializeSetTimerParameters

ExSetTimer