• WaitForSingleObject 和 WaitForMultipleObjects函数


    1.WaitForSingleObject
     等待函数可使线程自愿进入等待状态,直到一个特定的内核对象变为已通知状态为止。这些等待函数中最常用的是WaitForSingleObject:
      DWORD WaitForSingleObject(HANDLE hObject, DWORD dwMilliseconds);
    当线程调用该函数时,第一个参数hObject标识一个能够支持被通知/未通 知的内核对象。第二个参数dwMilliseconds.允许该线程指明,为了等待该对象变为已通知状态,它将等待多长时间。调用下面这个函数将告诉系 统,调用函数准备等待到hProcess句柄标识的进程终止运行为止:
    WaitForSingleObject(hProcess, INFINITE);
    第二个参数告诉系统,调用线程愿意永远等待下去(无限时间量),直到该进程终止运行。
    通常情况下, INFINITE是作为第二个参数传递给WaitForSingleObject的,不过也可以传递任何一个值(以毫秒计算)。顺便说一下, INFINITE已经定义为0xFFFFFFFF(或-1)。当然,传递INFINITE有些危险。如果对象永远不变为已通知状态,那么调用线程永远不会 被唤醒,它将永远处于死锁状态,
    不过,它不会浪费宝贵的CPU时间。
    下面是如何用一个超时值而不是INFINITE来调用WaitForSingleObject的例子:
    DWORD dw = WaitForSingleObject(hProcess, 5000);
    switch(dw)
    {
       case WAIT_OBJECT_0:
          // The process terminated.
          break;
       case WAIT_TIMEOUT:
          // The process did not terminate within 5000 milliseconds.
          break;
       case WAIT_FAILED:
          // Bad call to function (invalid handle?)
          break;
    }
    上面这个代码告诉系统,在特定的进程终止运行之前,或者在5 0 0 0 m s时间结束之前,调用线程不应该变为可调度状态。因此,如果进程终止运行,那么这个
    函数调用将在不到5000ms的时间内返回,如果进程尚未终止运行,那么它在大约5000ms时间内返回。注意,不能为dwMilliseconds传递0。如果传递了0,WaitForSingleObject函数将总是立即返回。

    2.WaitForMultipleObjects
    WaitForSingleObject的返回值能够指明调用线程为什么再次变为可调度状态。如果线程等待的对象变为已通知状态,那么返回值是 WAIT_OBJECT_0。如果设置的超时已经到期,则返回值是WAIT_TIMEOUT。如果将一个错误的值(如一个无效句柄)传递给 WaitForSingleObject,那么返回值将是WAIT_FAILED(若要了解详细信息,可调用GetLastError)。
    下面这个函数WaitForMultipleObjects与WaitForSingleObject函数很相似,区别在于它允许调用线程同时查看若干个内核对象的已通知状态:
    DWORD WaitForMultipleObjects(DWORD dwCount,
       CONST HANDLE* phObjects,
       BOOL fWaitAll,
       DWORD dwMilliseconds);
    dwCount参数用于指明想要让函数查看的内核对象的数量。这个值必须在1与MAXIMUM_WAIT_OBJECTS(在Windows头文件中定义为64)之间。phObjects参数是指向内核对象句柄的数组的指针。
    可以以两种不同的方式来使用WaitForMultipleObjects函数。
    一种方式是让线程进入等待状态,直到指定内核对象中的任何一个变为已通知状态。
    另一种方式是让线程进入等待状态,直到所有指定的内核对象都变为已通知状态。fWaitAll参数告诉该函数,你想要让它使用何种方式。如果为该参数传递TRUE,那么在所有对象变为已通知状态之前,该函数将不允许调用线程运行。
    dwMilliseconds参数的作用与它在WaitForSingleObject中的作用完全相同。如果在等待的时候规定的时间到了,那么该函数无论如何都会返回。同样,通常为该参数传递INFINITE,但是在编写代码时应该小心,以避免出现死锁情况。
    WaitForMultipleObjects函数的返回值告诉调用线程,为 什么它会被重新调度。可能的返回值是WAIT_FAILED和WAIT_TIMEOUT,这两个值的作用是很清楚的。如果fWaitAll参数传递 TRUE,同时所有对象均变为已通知状态,那么返回值是WAIT_OBJECT_0。如果为fWaitAll传递FALSE,那么一旦任何一个对象变为已 通知状态,该函数便返回。在这种情况下,你可能想要知道哪个对象变为已通知状态。返回值是WAIT_OBJECT_0 与(WAIT_OBJECT_0 + dwCount-1)之间的一个值。换句话说,如果返回值不是WAIT_TIMEOUT,也不是WAIT_FAILED,那么应该从返回值中减去 WAIT_OBJECT_0。产生的数字是作为第二个参数传递给WaitForMultipleObjects的句柄数组中的索引。该索引说明哪个对象变 为已通知状态。
    下面是说明这一情况的一些示例代码:
    HANDLE h[3];
    h[0] = hProcess1;
    h[1] = hProcess2;
    h[2] = hProcess3;
    DWORD dw = WaitForMultipleObjects(3, h, FALSE, 5000);
    switch(dw)
    {
       case WAIT_FAILED:
          // Bad call to function (invalid handle?)
          break;
       case WAIT_TIMEOUT:
          // None of the objects became signaled within 5000 milliseconds.
          break;
       case WAIT_OBJECT_0 + 0:
          // The process identified by h[0] (hProcess1) terminated.
          break;
       case WAIT_OBJECT_0 + 1:
          // The process identified by h[1] (hProcess2) terminated.
          break;
       case WAIT_OBJECT_0 + 2:
          // The process identified by h[2] (hProcess3) terminated.
          break;
    }
    如果为fWaitAll参数传递 FALSE,WaitForMultipleObjects就从索引0开始向上对句柄数组进行扫描,同时已通知的第一个对象终止等待状态。这可能产生一些 你不希望有的结果。例如,通过将3个进程句柄传递给该函数,你的线程就会等待3个子进程终止运行。如果数组中索引为0的进程终止运 行,WaitForMultipleObjects就会返回。这时该线程就可以做它需要的任何事情,然后循环反复,等待另一个进程终止运行。如果该线程传 递相同的3个句柄,该函数立即再次返回WAIT_OBJECT_0。除非删除已经收到通知的句柄,否则代码就无法正确地运行。
  • 相关阅读:
    失落的情
    我有个想法------彩南书屋
    西藏旅游闲记(上)
    夜归
    宝石山再记
    学车的日子(一)
    BootStrapValidator表单验证插件的学习和使用
    shard_row_id_bits & pre_split_regions
    某某大肠_tikv_修改配置参数
    第十二周总结
  • 原文地址:https://www.cnblogs.com/zsq1993/p/6031725.html
Copyright © 2020-2023  润新知