SetWaitableTimer

定時的時間通過調用SetWaitableTimer()來設定,可以設定為一個特定的時刻(如December 16, 1999 at 9:45 PM)或者一個相對的時間(如從現在起每五分鐘)。函式SetWaitableTime()定時的時間參數要求LARGE_INTEGER類型。這個值應該符合在結構體FILETIME中描述的格式。如果值是正的,代表一個特定的時刻。如果值是負的,代表以100納秒為單位的相對時間。後面的示例代碼中使用的是相對時間。在調用SetWaitableTimer()函式後,定時器將在每5秒被激發一次.

基本介紹

  • 中文名:SetWaitableTimer
  • 類型:函式
  • 隸屬:程式代碼
  • 說明:啟動一個可等待計時器
函式,說明,

函式

BOOL SetWaitableTimer( HANDLE hTimer,
const LARGE_INTEGER* pDueTime,
LONG lPeriod,
PTIMERAPCROUTINE pfnCompletionRoutine,
LPVOID lpArgToCompletionRoutine,
BOOL fResume);
h Ti m e r參數用於指明你要設定的定時器。
pDueTime和lPeriod兩個參數是一道使用的。pDueTime參數用於指明定時器何時應該第一次報時,而lPeriod參數則用於指明此後定時器應該間隔多長時間報時一次.
VB聲明 Declare Function SetWaitableTimer Lib "kernel32" (ByVal hTimer As Long, lpDueTime As FILETIME, ByVal lPeriod As Long, ByVal pfnCompletionRoutine As Long, ByVal lpArgToCompletionRoutine As Long, ByVal fResume As Boolen) As Long

說明

啟動一個可等待計時器。將它設為未發信號狀態 返回值 Long,非零表示成功,零表示失敗。會設定GetLastError 參數表 參數 類型及說明 hTimer Long,指定一個可等待計時器的句柄 lpDueTime FILETIME,指定一個包含了64位時間值的結構。如果為正,它代表計時器要觸發的時間。如果為負,它代表自函式調用以來持續的時間。時間是以100ns為單位指定的 lPeriod Long,如果為零,這個計時器只會觸發一次。否則,計時器會根據這裡設定的持續時間自動重新啟動(以毫秒為單位指定) pfnCompletionRoutine Long,指定零或者計時器觸發時要調用的一個函式的地址。可在標準模組中用一個函式通過AddressOf操作符提供這個地址。或者使用此類ocx控制項。最終的例程採取下述形式:
Sub myfunc(ByVal lpArgToCompletion&, ByVal dwTimerLow&, ByVal dwTimerHigh&) lpArgToCompletionRoutine Long,傳遞給最終例程的值 fResume Long,如果為TRUE,而且系統支持電源管理,那么在計時器觸發的時候,系統會退出省電模式。如設為TRUE,但系統不支持省電模式,GetLastError就會返回ERROR_NOT_SUPPORTED 適用平台
Windows NT

相關詞條

熱門詞條

聯絡我們