(Windows 通訊端 2) 的事件物件

重迭 i/o 的導入需要一種機制,讓應用程式明確地建立傳送和接收要求與其後續完成指示之間的關聯。 在 Windows 通訊端2中,這是透過在 Windows 事件之後模型化的事件物件來完成。 Windows 通訊端事件物件是相當簡單的結構,可建立和關閉、設定和清除,以及等候和輪詢。 其主要的公用程式是讓應用程式封鎖並等候一或多個事件物件變成設定的能力。

應用程式會使用 WSACreateEvent 來取得事件物件控制碼,該控制碼接著可作為必要參數提供給傳送和接收呼叫的重迭版本, ( WSASendWSASendToWSARecvWSARecvFrom) 。 在第一次建立時清除的事件物件,會在相關聯的重迭 i/o 作業已完成 (成功或) 錯誤時,由傳輸提供者設定。 WSACreateEvent 所建立的每個事件物件都應該有相符的 WSACloseEvent來終結它。

事件物件也會在 WSAEventSelect 中用來將一個或多個 FD _ XXX 網路事件與事件物件產生關聯。 這在 使用事件物件的非同步通知中有描述。

在32位環境中,與事件物件相關的函式(包括 WSACreateEventWSACloseEventWSASetEventWSAResetEventWSAWaitForMultipleEvents )會使用相同的函式名稱(但不含 WSA 前置詞)直接對應至對應的原生 Windows 函數。