timeSetEvent函数

该的timeSetEvent功能启动指定的定时器事件。多媒体计时器在其自己的线程中运行。事件激活后，它会调用指定的回调函数，或设置或脉冲指定的事件对象。

句法

C ++

MMRESULT timeSetEvent（
   UINT uDelay，
   UINT uResolution，
   LPTIMECALLBACK lpTimeProc，
   DWORD_PTR dwUser，
   UINT fuEvent
）;

参数

udelay的

事件延迟，以毫秒为单位。如果该值不在定时器支持的最小和最大事件延迟的范围内，则该函数返回错误。

uResolution

定时器事件的解析度，以毫秒为单位。分辨率随着较小的值而增加; 分辨率为0表示定期事件应该尽可能准确地发生。但是，为了减少系统开销，您应该使用适合您的应用程序的最大值。

lpTimeProc

指向一个回调函数的指针，该函数在单个事件到期时调用一次，或者在周期性事件到期时定期调用。

如果fuEvent指定了TIME_CALLBACK_EVENT_SET或TIME_CALLBACK_EVENT_PULSE标志，则lpTimeProc参数将被解释为事件对象的句柄。该事件将在单个事件完成后定期或脉冲，或定期事件完成后定期进行。

对于fuEvent的任何其他值，lpTimeProc参数是指向LPTIMECALLBACK类型的回调函数的指针。

dwUser

用户提供的回调数据。

fuEvent

定时器事件类型。该参数可能包含以下值之一。

值	含义
TIME_ONESHOT	在uDelay毫秒后发生一次事件。
TIME_PERIODIC	事件每uDelay毫秒发生一次。

 

所述fuEvent参数还可以包括以下值中的一个。

值	含义
TIME_CALLBACK_FUNCTION	当计时器到期时，Windows调用lpTimeProc参数指向的函数。这是默认设置。
TIME_CALLBACK_EVENT_SET	当计时器到期时，Windows调用SetEvent函数来设置由lpTimeProc参数指向的事件。该dwUser参数被忽略。
TIME_CALLBACK_EVENT_PULSE	当计时器到期时，Windows调用PulseEvent函数来脉冲由lpTimeProc参数指向的事件。该dwUser参数被忽略。
TIME_KILL_SYNCHRONOUS	传递该标志可防止在调用timeKillEvent函数后发生事件。

 

返回值

如果成功则返回定时器事件的标识符，否则返回错误。如果失败并且未创建定时器事件，则此函数返回NULL。（这个标识符也被传递给回调函数。）

备注

每次调用timeSetEvent以获得周期性定时器事件都需要对timeKillEvent函数进行相应的调用。

使用TIME_KILL_SYNCHRONOUS和TIME_CALLBACK_FUNCTION标志创建事件可防止在调用timeKillEvent函数后发生该事件。

要求

最低支持的客户端	Windows XP [仅限桌面应用]
最低支持的服务器	Windows Server 2003 [仅适用于桌面应用程序]
头	TimeAPI.h（包括Windows.h）; Windows Server 2008 R2，Windows 7，Windows 7，Windows Server 2008和Windows Vista上的Mmsystem.h（包括Windows.h）
图书馆	WINMM.LIB
DLL	WINMM.DLL