C语言SetTimer函数详解：多线程编程中的定时器机制285

在C语言编程中，实现定时器功能常常是必要的，例如游戏开发中的计时、网络编程中的心跳包发送、以及GUI程序中的定时更新等等。Windows API提供了一个名为`SetTimer`的函数，可以方便地创建和管理定时器。本文将深入探讨`SetTimer`函数的用法，包括其函数原型、参数详解、使用方法以及一些常见问题和解决方法，并结合代码示例进行说明。

`SetTimer`函数原型：

UINT_PTR SetTimer(HWND hWnd, UINT_PTR nIDEvent, UINT uElapse, TIMERPROC lpTimerFunc);

参数详解：

* `hWnd`: (HWND) 窗口句柄。如果定时器与某个窗口关联，则设置为该窗口的句柄；否则，设置为NULL。当定时器超时时，如果`hWnd`不为NULL，系统会向该窗口发送一个`WM_TIMER`消息。
* `nIDEvent`: (UINT_PTR) 定时器ID。一个非零的整数，用于标识该定时器。同一个窗口可以拥有多个定时器，不同的定时器需要不同的ID。通过这个ID，可以利用`KillTimer`函数来销毁对应的定时器。
* `uElapse`: (UINT) 定时器超时时间间隔，单位为毫秒。
* `lpTimerFunc`: (TIMERPROC) 定时器回调函数指针。当定时器超时时，系统会调用该函数。如果设置为NULL，则系统会在窗口的消息队列中添加`WM_TIMER`消息。

返回值：

如果函数成功，则返回一个非零的定时器ID；如果函数失败，则返回零。可以使用`GetLastError`函数获取错误代码。

定时器回调函数 `TIMERPROC`：

VOID CALLBACK TimerProc(HWND hwnd, UINT uMsg, UINT_PTR idEvent, DWORD dwTime);

参数含义：
`hwnd`: (HWND) 与定时器关联的窗口句柄。
`uMsg`: (UINT) 消息类型，始终为`WM_TIMER`。
`idEvent`: (UINT_PTR) 定时器ID。
`dwTime`: (DWORD) 定时器超时的时间值。

使用方法：

1. 创建定时器：使用`SetTimer`函数创建定时器，指定窗口句柄、定时器ID、超时时间间隔以及回调函数。

2. 处理定时器事件：如果`lpTimerFunc`参数不为NULL，则系统直接调用回调函数。如果`lpTimerFunc`为NULL，则系统向`hWnd`窗口发送`WM_TIMER`消息。在窗口过程函数中，需要处理`WM_TIMER`消息，根据`idEvent`来区分不同的定时器。

3. 销毁定时器：使用`KillTimer`函数销毁定时器。 `KillTimer(hWnd, nIDEvent);` 其中`hWnd`和`nIDEvent`与`SetTimer`函数中使用的参数相同。

代码示例 (使用回调函数):```c
#include
#include
VOID CALLBACK TimerProc(HWND hwnd, UINT uMsg, UINT_PTR idEvent, DWORD dwTime) {
static int count = 0;
count++;
printf("Timer %d fired! Count: %d", idEvent, count);
if (count >= 5) {
KillTimer(hwnd, idEvent);
printf("Timer stopped.");
}
}
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
HWND hwnd = CreateWindowEx(0, L"MyWindowClass", L"Timer Example", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, 300, 200, NULL, NULL, hInstance, NULL);
if (hwnd == NULL) return 0;
ShowWindow(hwnd, nCmdShow);
UINT_PTR timerID = SetTimer(hwnd, 1, 1000, TimerProc); // 1秒触发一次
MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return 0;
}
```

代码示例 (使用WM_TIMER消息):```c
#include
#include
LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
static int count = 0;
switch (uMsg) {
case WM_CREATE:
SetTimer(hwnd, 1, 1000, NULL); // 1秒触发一次，不使用回调函数
return 0;
case WM_TIMER:
count++;
printf("Timer fired! Count: %d", count);
if (count >= 5) {
KillTimer(hwnd, 1);
printf("Timer stopped.");
}
return 0;
case WM_DESTROY:
PostQuitMessage(0);
return 0;
default:
return DefWindowProc(hwnd, uMsg, wParam, lParam);
}
}
// ... (rest of WinMain function similar to previous example) ...
```