CreateThreadpoolTimer 函式 (threadpoolapiset.h)
建立新的計時器物件。
語法
PTP_TIMER CreateThreadpoolTimer(
[in] PTP_TIMER_CALLBACK pfnti,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
參數
[in] pfnti
每次計時器物件到期時要呼叫的回呼函式。 如需詳細資訊，請參閱 TimerCallback。
[in, out, optional] pv
要傳遞至回呼函式的選擇性應用程式定義資料。
[in, optional] pcbe
定義要在其中執行回呼之環境的 TP_CALLBACK_ENVIRON 結構。 InitializeThreadpoolEnvironment函式會傳回這個結構。
如果此參數為 Null，則回呼會在預設回呼環境中執行。 如需詳細資訊，請參閱 InitializeThreadpoolEnvironment。
傳回值
如果函式成功，它會傳回定義計時器物件的 TP_TIMER 結構的指標。 應用程式不會修改這個結構的成員。
如果函式失敗，它會傳回 Null。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。
備註
若要設定計時器物件，請呼叫 SetThreadpoolTimer 函式。
若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0600或更高版本。
範例
如需範例，請參閱 使用執行緒集區函式。
規格需求
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | threadpoolapiset.h (Windows 7、Windows Server 2008 Windows Server 2008 R2) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |