wince 等待函数

wince 等待函数

等待函数是使一个线程自愿进入等待状态，直到指定的内核对象被出发为止。注意如果线程在调用的一个等待函数的时候，相应的内核对象已经处于触发状态，那么线程是不会进入等待状态的。等待函数经常用来阻塞线程来进行同步，在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中间的任何一个值，即我们在第二个参数中传递给函数的句柄数组的一个索引，用来告诉我们被触发的是哪个对象。