8.2.3 WSAEventSelect
Wi n s o c k提供了另一個有用的異步I / O模型。和W S A A s y n c S e l e c t模型類似的是，它也允許應用程序在一個或多個套接字上，接收以事件為基礎的網絡事件通知。對于表8 - 3總結的、由W S A A s y n c S e l e c t模型采用的網絡事件來說，它們均可原封不動地移植到新模型。在用新模型開發的應用程序中，也能接收和處理所有那些事件。該模型最主要的差別在于網絡事件會投遞至一個事件對象句柄，而非投遞至一個窗口例程。
事件通知
事件通知模型要求我們的應用程序針對打算使用的每一個套接字，首先創建一個事件對象。創建方法是調用W S A C r e a t e E v e n t函數，它的定義如下：
WSAEVENT WSACreateEvent(void);
W S A C r e a t e E v e n t函數的返回值很簡單，就是一個創建好的事件對象句柄。事件對象句柄到手后，接下來必須將其與某個套接字關聯在一起，同時注冊自己感興趣的網絡事件類型，如表8 - 3所示。要做到這一點，方法是調用W S A E v e n t S e l e c t函數，對它的定義如下：
int WSAEventSelect(
??????????SOCKET s,?
??????????WSAEVENT hEventObject,
??????????long?lNetwordEvents
?????????);
?其中， s參數代表自己感興趣的套接字。h E v e n t O b j e c t參數指定要與套接字關聯在一起的?事件對象—用W S A C r e a t e E v e n t取得的那一個。而最后一個參數l N e t w o r k E v e n t s，則對應一個“位掩碼”，用于指定應用程序感興趣的各種網絡事件類型的一個組合（如表8 - 3所示）。要想獲知對這些事件類型的詳細說明，請參考早先討論過的WSAAsyncSelect I/O模型。
為W S A E v e n t S e l e c t創建的事件擁有兩種工作狀態，以及兩種工作模式。其中，兩種工作狀態分別是“已傳信”（s i g n a l e d）和“未傳信”（n o n s i g n a l e d）。工作模式則包括“人工重設”（manual reset）和“自動重設”（auto reset）。W S A C r e a t e E v e n t最開始在一種未傳信的工作狀態中，并用一種人工重設模式，來創建事件句柄。隨著網絡事件觸發了與一個套接字關聯在
一起的事件對象，工作狀態便會從“未傳信”轉變成“已傳信”。由于事件對象是在一種人工重設模式中創建的，所以在完成了一個I / O請求的處理之后，我們的應用程序需要負責將工作狀態從已傳信更改為未傳信。要做到這一點，可調用W S A R e s e t E v e n t函數，對它的定義如下：
?BOOL ?WSAResetEvent(WSAEVENT hEvent);
?
?該函數唯一的參數便是一個事件句柄；基于調用是成功還是失敗，會分別返回T R U E或FA L S E。應用程序完成了對一個事件對象的處理后，便應調用W S A C l o s e E v e n t函數，釋放由事件句柄使用的系統資源。對W S A C l o s e E v e n t函數的定義如下：
?BOOL WSACloseEvent(WSAEVENT hEvent);
?
?該函數也要拿一個事件句柄作為自己唯一的參數，并會在成功后返回T R U E，失敗后返回FA L S E。
一個套接字同一個事件對象句柄關聯在一起后，應用程序便可開始I / O處理；方法是等待網絡事件觸發事件對象句柄的工作狀態。W S AWa i t F o r M u l t i p l e E v e n t s函數的設計宗旨便是用來等待一個或多個事件對象句柄，并在事先指定的一個或所有句柄進入“已傳信”狀態后，或在超過了一個規定的時間周期后，立即返回。下面是W S AWa i t F o r M u l t i p l e E v e n t s函數的定義：
DWORD WSAWaitForMultipleEvents(
????????????????DWORD cEvent,
????????????????const WSAEVENT?FAR * lphEvents,
????????????????BOOL ?fWaitAll,
????????????????DWORD dwTimeout,
????????????????BOOL? fAlertable
???????????????);
???????????????
?其中， c E v e n t s和l p h E v e n t s參數定義了由W S A E V E N T對象構成的一個數組。在這個數組中，c E v e n t s指定的是事件對象的數量，而l p h E v e n t s對應的是一個指針，用于直接引用該數組。
要注意的是， W S AWa i t F o r M u l t i p l e E v e n t s只能支持由W S A _ M A X I M U M _ WA I T _ E V E N T S對象規定的一個最大值，在此定義成6 4個。因此，針對發出W S AWa i t F o r M u l t i p l e E v e n t s調用的每個線程，該I / O模型一次最多都只能支持6 4個套接字。假如想讓這個模型同時管理不止6 4個套
接字，必須創建額外的工作者線程，以便等待更多的事件對象。f Wa i t A l l 參數指定了W S AWa i t F o r M u l t i p l e E v e n t s如何等待在事件數組中的對象。若設為T R U E，那么只有等l p h E v e n t s數組內包含的所有事件對象都已進入“已傳信”狀態，函數才會返回；但若設為FA L S E，任何一個事件對象進入“已傳信”狀態，函數就會返回。就后一種情況來說，返回值指出了到底是哪個事件對象造成了函數的返回。通常，應用程序應將該參數設為FA L S E，
一次只為一個套接字事件提供服務。d w Ti m e o u t參數規定了W S AWa i t F o r M u l t i p l e E v e n t s最多可等待一個網絡事件發生有多長時間，以毫秒為單位，這是一項“超時”設定。超過規定的時間，函數就會立即返回，即使由f Wa i t A l l參數規定的條件尚未滿足也如此。如超時值為0，函數會檢測指定的事件對象的狀態，并立即返回。這樣一來，應用程序實際便可實現對事件對
象的“輪詢”。但考慮到它對性能造成的影響，還是應盡量避免將超時值設為0。假如沒有等待處理的事件， W S AWa i t F o r M u l t i p l e E v e n t s便會返回W S A _ WA I T _ T I M E O U T。如d w s Ti m e o u t設為W S A _ I N F I N I T E（永遠等待），那么只有在一個網絡事件傳信了一個事件對象后，函數才
會返回。最后一個參數是f A l e r t a b l e，在我們使用W S A E v e n t S e l e c t模型的時候，它是可以忽略的，且應設為FA L S E。該參數主要用于在重疊式I / O模型中，在完成例程的處理過程中使用。
本章后面還會對此詳述。
若W S AWa i t F o r M u l t i p l e E v e n t s收到一個事件對象的網絡事件通知，便會返回一個值，指出造成函數返回的事件對象。這樣一來，我們的應用程序便可引用事件數組中已傳信的事件，并檢索與那個事件對應的套接字，判斷到底是在哪個套接字上，發生了什么網絡事件類型。
對事件數組中的事件進行引用時，應該用W S AWa i t F o r M u l t i p l e E v e n t s的返回值，減去預定義值W S A _ WA I T _ E V E N T _ 0，得到具體的引用值（即索引位置）。如下例所示：
Index = WSAWaitForMultipleEvents(...);
MyEvent = EventArray[Index - WSA_WAIT_EVENT_0];
知道了造成網絡事件的套接字后，接下來可調用W S A E n u m N e t w o r k E v e n t s函數，調查發生了什么類型的網絡事件。該函數定義如下：
?int WSAEnumNetworkEvents(
??????????????SOCKET s,
??????????????WSAEVENT hEventObject,
??????????????LPWSANETWORKEVENTS lpNetworkEvents
?????????????);
?s參數對應于造成了網絡事件的套接字。h E v e n t O b j e c t參數則是可選的；它指定了一個事件句柄，對應于打算重設的那個事件對象。由于我們的事件對象處在一個“已傳信”狀態，所以可將它傳入，令其自動成為“未傳信”狀態。如果不想用h E v e n t O b j e c t參數來重設事件，那么可使用W S A R e s e t E v e n t 函數， 該函數早先已經討論過了。最后一個參數是l p N e t w o r k E v e n t s，代表一個指針，指向W S A N E T W O R K E V E N T S結構，用于接收套接字上發
生的網絡事件類型以及可能出現的任何錯誤代碼。下面是W S A N E T W O R K E V E N T S結構的定義：
?typedef struct _WSANETWORKEVENTS
?{
??long lNetworkEvents;
??int iErrorCode[FD_MAX_EVENTS];
?}WSANETWORKEVENTS,FAR * LPWSANETWORKEVENTS;
?
?l N e t w o r k E v e n t s參數指定了一個值，對應于套接字上發生的所有網絡事件類型（參見表8 - 3）。
注意一個事件進入傳信狀態時，可能會同時發生多個網絡事件類型。例如，一個繁忙
的服務器應用可能同時收到FD_READ和FD_WRITE通知。
i E r r o r C o d e參數指定的是一個錯誤代碼數組，同l N e t w o r k E v e n t s中的事件關聯在一起。針對每個網絡事件類型，都存在著一個特殊的事件索引，名字與事件類型的名字類似，只是要在事件名字后面添加一個“ _ B I T”后綴字串即可。例如，對F D _ R E A D事件類型來說，i E r r o r C o d e數組的索引標識符便是F D _ R E A D _ B I T。下述代碼片斷對此進行了闡釋（針對F D _ R E A D事件）：
??if(NetWorkEvents.lNetworkEvents & FD_READ)
??{
???if(NetWorkEvents.iErrorCode[FD_READ_BIT] != 0)
???{
????printf("FD_READ FAILED with error %d\n",NetWorkEvents.iErrorCode[FD_READ_BIT]);
???}
??}
完成了對W S A N E T W O R K E V E N T S結構中的事件的處理之后，我們的應用程序應在所有可用的套接字上，繼續等待更多的網絡事件。在程序清單8 - 6中，我們闡釋了如何使用W S A E v e n t S e l e c t這種I / O模型，來開發一個服務器應用，同時對事件對象進行管理。這個程序主要著眼于開發一個基本的服務器應用要涉及到的步驟，令其同時負責一個或多個套接字的管理。
完成了對W S A N E T W O R K E V E N T S結構中的事件的處理之后，我們的應用程序應在所有可用的套接字上，繼續等待更多的網絡事件。在程序清單8 - 6中，我們闡釋了如何使用W S A E v e n t S e l e c t這種I / O模型，來開發一個服務器應用，同時對事件對象進行管理。這個程序主要著眼于開發一個基本的服務器應用要涉及到的步驟，令其同時負責一個或多個套接字的管理。
程序清單8-6 采用WSAEventSelect I/O模型的示范服務器源代碼