(轉)WaitForSingleObject函數的使用

標籤：

WaitForSingleObject 函數

DWORD WaitForSingleObject(

HANDLE hObject,

     DWORD dwMilliseconds

);

第一個參數hObject標識一個能夠支援被通知/未通知的核心對象（前面列出的任何一種對象都適用）。

第二個參數dwMilliseconds允許該線程指明，為了等待該對象變為已通知狀態，它將等待多長時間。（INFINITE為無限時間量，INFINITE已經定義為0xFFFFFFFF（或-1））

傳遞INFINITE有些危險。如果對象永遠不變為已通知狀態，那麼調用線程永遠不會被喚醒，它將永遠處於死結狀態，不過，它不會浪費寶貴的C P U時間。

 

例子：

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;

}

上面這個代碼告訴系統，在特定的進程（hProcess）終止運行(進程hProcess終止運行變成已經通知)之前，或者在5000m s時間結束之前，調用線程不應該變為可調度狀態。

 WaitForSingleObject的傳回值能夠指明調用線程為什麼再次變為可調度狀態。

如果線程等待的對象變為已通知狀態，那麼傳回值是WAIT_OBJECT_0。

如果設定的逾時已經到期，則傳回值是WAIT_TIMEOUT。

如果將一個錯誤的值（如一個無效控制代碼）傳遞給WaitForSingleObject，那麼傳回值將是WAIT_FAILED（若要瞭解詳細資料，可調用GetLastError）。

 

WaitForMultipleObjects函數

WaitForMultipleObjects函數與WaitForSingleObject函數很相似，區別在於它允許調用線程同時查看若干個核心對象的已通知狀態：

DWORD WaitForMultipleObjects(

DWORD dwCount,

   CONST HANDLE* phObjects,

   BOOL fWaitAll,

   DWORD dwMilliseconds

);

dwCount參數用於指明想要讓函數查看的核心對象的數量。這個值必須在1與MAXIMU M_WAIT_OBJECTS（在Windows標頭檔中定義為64）之間。

phObjects參數是指向核心物件控點的數組的指標。

 

可以以兩種不同的方式來使用WaitForMultipleObjects函數。

一種方式是讓線程進入等待狀態，直到指定核心對象中的任何一個變為已通知狀態。

另一種方式是讓線程進入等待狀態，直到所有指定的核心對象都變為已通知狀態。

fWaitAll參數告訴該函數，你想要讓它使用何種方式。如果為該參數傳遞TRUE，那麼在所有對象變為已通知狀態之前，該函數將不允許調用線程運行。

dwMilliseconds參數的作用與它在WaitForSingleObject中的作用完全相同。如果在等待的時候規定的時間到了，那麼該函數無論如何都會返回。。

WaitForMultipleObjects函數的傳回值告訴調用線程，為什麼它會被重新調度。可能的傳回值是WAIT_FAILED和WAIT_TIMEOUT。如果為fWaitAl l參數傳遞TRUE，同時所有對象均變為已通知狀態，那麼傳回值是WAIT_OBJECT_0。如果為fWaitAll傳遞FALSE，那麼一旦任何一個對象變為已通知狀態，該函數便返回。在這種情況下，你可能想要知道哪個對象變為已通知狀態。傳回值是WAIT_OBJECT_0與（WAIT_OJECT_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;

}

轉自http://www.cnblogs.com/fangyukuan/archive/2010/09/03/1817095.html

(轉)WaitForSingleObject函數的使用