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 부터 지원합니다.
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

추가 정보

ExInitializeSetTimerParameters

ExSetTimer