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