timeSetEvent函数

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

句法
C ++

MMRESULT timeSetEvent(
   UINT uDelay,
   UINT uResolution,
   LPTIMECALLBACK lpTimeProc,
   DWORD_PTR dwUser,
   UINT fuEvent
);

参数

udelay的

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

uResolution

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

lpTimeProc

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

如果fuEvent指定了TIME_CALLBACK_EVENT_SETTIME_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_SYNCHRONOUSTIME_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

你可能感兴趣的:(C++,windows)