等候函数是使一个线程自愿进入等候状况,直到指定的内核目标被动身停止。留意假如线程在调用的一个等候函数的时分,相应的内核目标现已处于触发状况,那么线程是不会进入等候状况的。等候函数常常用来堵塞线程来进行同步,在IST顶用到来等候相应的中止事情。常用的等候函数是:WaitForSingleObject()。函数原型如下:
DWORD WaitForSingleObject(
HANDLE hObject,
DWORD dwMilliseconds);
第一个参数hObject代表要等带的内核目标,第二个参数dwMilliseconds代表要等候的毫秒数。假如到等候的时刻抵达,内核目标还没有被触发,则函数回来等候超时。
在wince中能够用来被等候的内核目标有:进程,线程,作业,文件以及控制台的规范输入流/输出流/过错流,事情,可等候的计时器,信号量,互斥量。其间事情,可等候的计时器,信号量以及互斥量是windows供给的专门用来线程同步的内核目标。
对第二个参数常常传递INFINITE,便是0xFFFFFFFF(-1)。当传递INFINITE的时分代表假如等候的内核目标永久不被触发,那么调用的线程就永久不会被唤醒,它会一向等候下去。当然在等候的过程中并没有占用CPU。
函数的回来值代表为什么调用线程又能够持续履行(线程进入安排妥当状况)。
WAIT_OBJECT_0:代表等候的内核目标被触发。
WAIT_TIMEOUT:代表等候超时。
WAIT_FAILED:代表传入的无效的参数,这时调用GetLastError能够获得更为具体的信息。
WaitForSingleObject是等带一个内核目标被触发。而WaitForMultipleObjects答应调用线程一起查看多个内核目标的触发状况,其函数原型如下:
DWORD WaitForMultipleObjects(
DWORD dwCount,
CONST HANDLE * phObjects,
BOOL bWaitAll,
DWORD dwMilliseconds);
dwCount表明咱们要检测的内核目标的个数。这个值必须在1-MAXIMUM_WAIT_OBJECTS之间。phObjects是一个指针,指向一个内核目标句柄的数组。bWaitALL为TRUE时表明要等一切的内核目标都被触发,为FALSE时表明所等候的内核目标中有一个被触发时,线程就会被唤醒。最终一个参数与WaitForSingleObject中的那个相同。
WaitForMultipleObjects函数的回来值告知调用函数为什么它能过持续运转。能够回来的值包含WAIT_FAILED和WAIT_TIMEOUT。
假如bWaitAll为True并且一切的目标都被触发了,那么回来值是WAIT_OBJECT_0.
假如bWaitAll为False,那么只需任何一个目标被触发,函数就会马上回来。这时回来值是WAIT_OBJECT_0和WAIT_OBJECT_0+dwCount-1中心的任何一个值,即咱们在第二个参数中传递给函数的句柄数组的一个索引,用来告知咱们被触发的是哪个目标。