多媒体定时器参考手册

Multimedia Timers

多媒体定时器服务，允许应用程序确定定时器事件的时间周期，那使应用程序在指定的时间间隔内，可以请求或接收定时器消息.

 About Multimedia Timers

 Using Multimedia Timers

 Multimedia Timer Reference

About Multimedia Timers

多媒体定时器服务，允许应用程序使用最高精确度，来调度定时器的事件，这与硬件平台有关，这些多媒体定时器服务允许你采用比

其他定时器精度高的多的定时器来响应定时器事件.

Using Multimedia Timers

这部分包含例子，示范如何实现如下任务。

 Obtaining and Setting Timer Resolution

 Starting a Single Timer Event

 Writing a Timer Callback Function

 Canceling a Timer Event

Obtaining and Setting Timer Resolution

下面的例子是在设置任何定时器事件前，调用 timeGetDevCaps 函数确定被定时器服务支持的定时器精度的最小和最大值. 此例

通过使用 timeBeginPeriod

函数确定定时器精度的最小值.

// Error; application can't continue.

}

wTimerRes = min(max(tc.wPeriodMin, TARGET_RESOLUTION), tc.wPeriodMax);

timeBeginPeriod(wTimerRes);

Starting a Single Timer Event

开始一个单一的定时器事件，应用程序必须调用 timeSetEvent 函数, 回调函数执行前要指定时间数量,精度、回调函数的地址 (见

TimeProc), 和用户数据与回调函数一起提供. 应用程序可以像如下所示的方法，开始一个单一定时器事件.

UINT SetTimerCallback(NPSEQ npSeq, // sequencer data

UINT msInterval) // event interval

{

if(! npSeq->wTimerID)

return ERR_TIMER;

else

return ERR_NOERROR;

}

回调函数 OneShotCallback 的实例, 见 Writing a Timer Callback Function.

Writing a Timer Callback Function

如下所示的回调函数，使单一定时器事件的标识符无效并且调用一个定时器例程处理应用程序指定的任务, 更多信息见 TimeProc.

void CALLBACK OneShotTimer(UINT wTimerID, UINT msg,

DWORD dwUser, DWORD dw1, DWORD dw2)

npSeq = (NPSEQ)dwUser;

npSeq->wTimerID = 0; // invalidate timer ID (no longer in use)

面的方法.

void DestroyTimer(NPSEQ npSeq)

Multimedia Timer Reference

这部分描述与多媒体定时器服务有关的函数和结构，根据功能按如下分组介绍：

――检索系统时间――

MMTIME

timeGetSystemTime

timeGetTime

――检索定时器信息――

TIMECAPS

timeGetDevCaps