struktur EXT_SET_PARAMETERS (wdm.h)

  • Artikel

Struktur EXT_SET_PARAMETERS berisi serangkaian parameter yang diperluas untuk rutinitas ExSetTimer .

Sintaks

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

Anggota

Version

Nomor versi struktur EXT_SET_PARAMETERS ini. Rutinitas ExInitializeSetTimerParameters mengatur anggota ini ke nomor versi yang benar.

Reserved

Atur ke nol. ExInitializeSetTimerParameters rutin mengatur anggota ini ke nol.

NoWakeTolerance

Waktu maksimum, dalam unit waktu sistem (interval 100 nanodetik), bahwa timer dapat menunggu untuk membangunkan prosesor setelah timer mencapai waktu kedaluwarsanya. Hanya setelah prosesor bangun, timer dapat kedaluwarsa. Jika timer diatur kedaluwarsa saat prosesor dalam status daya rendah, timer tidak akan membangunkan prosesor untuk kedaluwarsa sampai waktu kedaluwarsa ditambah penundaan NoWakeTolerance terlampaui. Sebagai opsi, driver dapat mengatur anggota ini ke EX_TIMER_UNLIMITED_TOLERANCE, yang menunjukkan bahwa timer tidak pernah membangunkan prosesor dan, dengan demikian, tidak dapat kedaluwarsa sampai prosesor bangun karena alasan lain.

Jangan atur anggota ini ke nilai negatif (selain EX_TIMER_UNLIMITED_TOLERANCE). Jika tidak, pemeriksaan bug rutin.

Keterangan

Parameter Parameter dari rutinitas ExSetTimer adalah penunjuk ke struktur EXT_SET_PARAMETERS. Sebelum meneruskan struktur EXT_SET_PARAMETERS ke rutinitas ini, panggil rutinitas ExInitializeSetTimerParameters untuk menginisialisasi struktur.

RutinItas ExInitializeSetTimerParameters menetapkan anggota NoWakeTolerance ke nol, yang berarti bahwa timer segera membangunkan prosesor jika timer mencapai waktu kedaluwarsanya ketika prosesor dalam keadaan berdaya rendah. Untuk mengurangi konsumsi daya, driver dapat mengatur anggota ini ke nilai bukan nol untuk memperpanjang waktu yang dihabiskan prosesor dalam status daya rendah.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 8.1.
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

ExInitializeSetTimerParameters

ExSetTimer