win32多線程-重寫訊息迴圈

最近正在學習《win32多線程程式設計》，這是其中一段重寫訊息迴圈的代碼案例，以後可能用的上。

  while (!quit || gNumPrinting > 0)    {   // Wait for next message or object being signaled        DWORD   dwWake;        dwWake = MsgWaitForMultipleObjects(                                gNumPrinting,                                gPrintJobs,                                FALSE,                                INFINITE,                                QS_ALLEVENTS);        if (dwWake >= WAIT_OBJECT_0 && dwWake < WAIT_OBJECT_0 + gNumPrinting)        {   // Object has been signaled            // Reorder the handle array so we do not leave            // empty slots. Take the handle at the end of            // the array and move it into the now-empty slot.            int index = dwWake - WAIT_OBJECT_0;            gPrintJobs[index] = gPrintJobs[gNumPrinting-1];            gPrintJobs[gNumPrinting-1] = 0;            gNumPrinting--;            SendMessage(hDlgMain, WM_THREADCOUNT, gNumPrinting, 0L);        } // end if        else if (dwWake == WAIT_OBJECT_0 + gNumPrinting)        {            while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE))            {   // Get Next message in queue                if(hDlgMain == NULL || !IsDialogMessage(hDlgMain,&msg))                {                    if (msg.message == WM_QUIT)                    {                        quit = TRUE;                        exitCode = msg.wParam;                        break;                    } // end if                    TranslateMessage(&msg);                    DispatchMessage(&msg);                }            } // end while        }    } // end while

說明：
MsgWaitForMultipleObjects函數
該函數的特點是它不但可以等待核心對象，還可以等訊息。也就是當有訊息到來時，該函數也一樣可以返回，並處理訊息，這樣就給了背景工作執行緒退出的機會。

DWORD MsgWaitForMultipleObjects(
DWORD nCount, //要等待的核心對象數目
LPHANDLE pHandles, //要等待的核心物件控點數組指標
BOOL fWaitAll, //是等待全部對象還是單個對象
DWORD dwMilliseconds,//等待時間 
DWORD dwWakeMask );//等待的訊息類型

下面就詳解一下該函數的參數使用方法：
DWORD nCount：要等待的核心對象的數目。如果等待兩個線程退出，則nCount=2；
LPHANDLE pHandles：要等待的核心物件控點數組指標。

如果只要等待一個線程退出，則直接設定該線程控制代碼的指標即可：
MsgWaitForMultipleObjects(1,&m_pThread->m_hThread,…)

如果要等待兩個線程退出，則使用方法為:
HANDLE hArray[2]={ m_pThread1->m_hThread , m_pThread2->m_hThread }；
MsgWaitForMultipleObjects(2,hArray,…)

BOOL fWaitAll： TRUE-表示只有要等待的線程全部退出後，此函數才返回，
               FALSE-表示要等待的線程中任意一個退出了，或是有訊息到達了，此函數均會返回。
在上面的OnButton2()函數中，我要等待一個線程退出，將fWaitAll設定為
FALSE，目的是無論是線程真的退出了，還是有訊息到達了，該函數都能返回。
如果將該fWaitAll設定為TRUE，那麼函數返回的唯一條件是線程退出了，即便
是有訊息到來了，該函數也一樣不會返回。

DWORD dwMilliseconds：等待的事件，單位是毫秒。可以設定為INFINITE，無
窮等待

DWORD dwWakeMask：等待的訊息類型，通常可以設定為QS_ALLINPUT。此宏表示的是可以等待任意類型的訊息。當然，也可以指定等待的訊息類型。

#define QS_ALLINPUT        (QS_INPUT         | \
                            QS_POSTMESSAGE   | \
                            QS_TIMER         | \
                            QS_PAINT         | \
                            QS_HOTKEY        | \
                            QS_SENDMESSAGE)

傳回值：DWORD dRet 通過函數傳回值，可以得到一些有效資訊。函數傳回值依fWaitAll設定的不同而有所不同。下面是函數傳回值的幾種常見類型：

dRet = 0xFFFFFFFF ：   表示函數調用失敗，可用GetLastError()得到具體的出錯資訊;

dRet =WAIT_OBJECT_0+nCount：表示有訊息到達了；

如果fWaitAll設定為TRUE

dRet = WAIT_OBJECT_0,表示所有等待的核心對象都激發了，或是線程都退出了；

如果fWaitAll設定為FALSE

dRet = WAIT_OBJECT_0 ~ WAIT_OBJECT_0+nCount-1：表示等待的核心對象被激發了，index=dRet - WAIT_OBJECT_0，表示hArray[]數組中索引為index的那個對象被激發了。