WaitForSingleObject函数的使用.pdfVIP

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 函数将总是立即返回。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中的作用完全相同。如果在等