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) |