Windows伺服器端編程－第二章 裝置IO與線程間通訊－7－將裝置與完成連接埠關聯

l       將裝置與完成連接埠關聯

在建立I/O完成連接埠時，實際上核心建立了5個不同的資料結構，如表2-1所示。在繼續閱讀之前應該參考一下。

 

表2-1 I/O完成連接埠的內部工作機制

 

       第一個資料是裝置列表，表示關聯到完成連接埠的一個或幾個裝置。通過調用CreateIoCompletionPort可以將裝置與連接埠關聯起來。我再次建立了自己的函數，AssociateDeviceWithCompletionPort，封裝對CreateIoCompletionPort的調用。

 

   BOOL AssociateDeviceWithCompletionPort(

   HANDLE hCompPort, HANDLE hDevice, DWORD dwCompKey) {

 

   HANDLE h = CreateIoCompletionPort(hDevice, hCompPort, dwCompKey, 0);

   return(h == hCompPort);

}

 

       AssociateDeviceWithCompletionPort在已存在的完成連接埠的裝置列表添加一個。調用時需要將已有的完成連接埠的控制代碼(由先前的CreateNewCompletionPort調用返回)，裝置控制代碼(可以是一個檔案，一個SOCKET連接埠，郵件槽，管道等等)，和完成索引值(有意義的值；作業系統不會關心究竟是什麼東西)傳入該函數。每次將裝置和連接埠相關聯，系統就會將資訊添加到完成連接埠的裝置列表中。

 

注意

CreateIoCompletionPort函數很複雜，建議在調用時要從意識上將其分為兩個理由。複雜的一個好處是：可以開啟檔案與建立新的完成連接埠。例如，下面的代碼開啟檔案和建立新的完成連接埠，並將檔案與之關聯。所有針對該檔案的I/O請求都在完成之後攜帶CK_FILE完成索引值，並且連接埠允許多至兩個線程並存執行。

 

#define CK_FILE   1

HANDLE hfile = CreateFile(...);

HANDLE hCompPort = CreateIoCompletionPort(hfile, NULL, CK_FILE, 2);

 

 

 

第二個資料結構是I/O完成隊列。當裝置的非同步I/O請求完成時，系統檢查裝置是否與完成連接埠相關聯，如果是，系統就將已完成的I/O請求添加到完成連接埠的I/O完成隊列中。隊列中的每個包含了傳輸的位元組數，在裝置與連接埠關聯時設定的完成索引值，I/O請求的OVERLAPPED結構指標，以及錯誤碼。後面將討論如何將從隊列中刪除。

 

注意

產生一個裝置I/O請求，且不將項加入到I/O完成連接埠的隊列中是可能的。通常這不是必須的，但有可能會遇到，例如，通過SOCKET發送資料，並且不關心資料是否發送與否。

要產生這樣的I/O請求，必須將OVERLAPPED結構的hEvent的成員置成一個有效事件控制代碼，並且通過位或操作將最高位置為1，像下面這樣：

 

Overlapped.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);

Overlapped.hEvent = (HANDLE) ((DWORD_PTR) Overlapped.hEvent | 1);

ReadFile(..., &Overlapped);

 

現在可以產生I/O請求，傳入OVERLAPPED結構的地址給需要的函數(例如上面的ReadFile)。

 

如果不用建立一個事件就可以停止I/O完成的隊列就最好了，例如下面的代碼。不過，它並不會起作用：

Overlapped.hEvent = 1;

ReadFile(..., &Overlapped);

 

另外，不要忘了在關閉事件控制代碼之前將其的低位複位：

CloseHandle((HANDLE) ((DWORD_PTR) Overlapped.hEvent & ~1));