Недокументированные функции NTDLL

7 января 2001



NtSetTimer (ZwSetTimer)

NTSYSAPI 
NTSTATUS
NTAPI

NtSetTimer(


  IN HANDLE               TimerHandle,
  IN PLARGE_INTEGER       DueTime,
  IN PTIMER_APC_ROUTINE   TimerApcRoutine OPTIONAL,
  IN PVOID                TimerContext OPTIONAL,
  IN BOOLEAN              ResumeTimer,
  IN LONG                 Period OPTIONAL,
  OUT PBOOLEAN            PreviousState OPTIONAL );



  • TimerHandle
    •     HANDLE таймера, открытый с доступом TIMER_MODIFY_STATE.
  • DueTime
    •     Время, за которое таймер должен быть установлен, в 100 нс интервалах. Отрицательное значение это относительное время.
  • TimerApcRoutine
    •     Пользовательская функция APC, определённая как: 
    	typedef void (*PTIMER_APC_ROUTINE)(
			IN PVOID TimerContext,
			IN ULONG TimerLowValue,
			IN LONG TimerHighValue
			);
  • TimerContext
    •     Дополнительный параметр для TimerApcRoutine.
  • ResumeTimer
    •     Если установлено, то управление электропитанием возвращает систему в нормальный режим в момент, когда таймер переходит в сигнальное состояние.
  • Period
    •     Если ноль, таймер устанавливается только один раз. Иначе он будет устанавливаться периодически, в интервалы времени, определённые в значении Period.
  • PreviousState
    •     Дополнительный указатель на значение, получающее состояние таймера перед вызовом функции NtSetTimer.


    Документировал:
    Томаш Новак



    Зависимости:
    Библиотека: ntdll.lib


    См. также:
    NtCancelTimer
    NtCreateTimer
    NtOpenTimer
    NtQueryTimer