windows编程学习——等待函数

 

                基本概念

 等待函数：等待函数会让一个线程自动进入等待状态，直到指定的内核对象被触发。

                  API

DWORD WaitForSingleObiect(

           HANDLE hObject,

           DWORD dwMilliseconds

);

作用：

使一个线程自动进去等待状态。

参数：

hObject是一个内核对象，这个内核对象可以处于触发状态或者未触发状态。

dwMilliseconds用来指定线程愿意用多长时间来等待对象被触发，取值可以是0-INFINITE。INFINITE表示线程愿意永远等待该内核对象被触发

返回值：

WaitForSingleObject的返回值表示为什么调用线程又能够继续执行了。

WAIT_OBJECT_0：表示因为等待对象被触发

WAIT_TIMEOUT：表示等待超时

WAIT_FAILED：传入了无效的参数

这些返回值可以使用GetLastError()获取

 

DWORD WaitForMultipleObjects(

DWORD         dwCount,

CONST HANDLE* phObjects,

BOOL           bWaitAll,

DWORD         dwMilliseconds

)

作用：

使一个线程可以同时检查多个内核对象的触发状态。

参数：

dwCount是我没希望函数检查的内核对象的数量，这个值必须在1-MAXIMUM_WAIT_OBJECTS(64)之间。

phObjects表示一个内核对象句柄的数组

bWaitAll表示该API的两种方式。TRUE表示，在所有内核对象还没被触发前，函数不允许调用线程继续执行。FALSE表示，有一个被触发，线程便可继续执行。

dwMilliseconds用来指定线程愿意用多长时间来等待对象被触发，取值可以是0-INFINITE。INFINITE表示线程愿意永远等待该内核对象被触发

 

 

返回值：

WaitForSingleObject的返回值表示为什么调用线程又能够继续执行了。

1.WAIT_TIMEOUT：表示等待超时

2.WAIT_FAILED：传入了无效的参数

3.如果bWaitAll传入的是TRUE而且所有的对象都被触发了，则返回WAIT_OBJECT_0。

 否则如果传入的是FALSE，则返回值是WAIT_OBJECT_0和（WAIT_OBJECT_0+dwCount-1）之间的任何一个值。

 

重点：当传入false时，我们可以用返回值减去WAIT_OBJECT_0来做数组的索引值，判断究竟是那个内核对象被触发。