前言：

    最近需要對Windows中的裝置進行程式設計操作，其中涉及到非常重要的函式DeviceIoControl，在使用的時候也比較的複雜，國內這一塊中文資料比較少，在學習之餘順便將其翻譯出來，以供參考，如有錯誤，歡迎指正。[email protected]點com 

    DeviceIoControl 將控制程式碼直接傳送到指定的裝置驅動程式，使相應的裝置執行相應的操作。

句法：

BOOL WINAPI DeviceIoControl(
  _In_        HANDLE       hDevice,
  _In_        DWORD        dwIoControlCode,
  _In_opt_    LPVOID       lpInBuffer,
  _In_        DWORD        nInBufferSize,
  _Out_opt_   LPVOID       lpOutBuffer,
  _In_        DWORD        nOutBufferSize,
  _Out_opt_   LPDWORD      lpBytesReturned,
  _Inout_opt_ LPOVERLAPPED lpOverlapped
);
 

引數：

hDevice [in]
    需要執行操作的裝置控制代碼。該裝置通常是卷，目錄，檔案或流，使用 CreateFile 函式開啟獲取裝置控制代碼。具體的見備註
dwIoControlCode [in]
    操作的控制程式碼，該值標識要執行的特定操作以及執行該操作的裝置的型別，有關控制程式碼的列表，請參考備註。每個控制程式碼的文件都提供了lpInBuffer，nInBufferSize，lpOutBuffer和nOutBufferSize引數的使用細節。
lpInBuffer [in, optional]
    （可選）指向輸入緩衝區的指標。這些資料的格式取決於dwIoControlCode

引數的值。如果dwIoControlCode指定不需要輸入資料的操作，則此引數可以為NULL。
nInBufferSize [in]
    輸入緩衝區以位元組為單位的大小。單位為位元組。
lpOutBuffer [out, optional]
    （可選）指向輸出緩衝區的指標。這些資料的格式取決於dwIoControlCode引數的值。如果dwIoControlCode指定不返回資料的操作，則此引數可以為NULL。
nOutBufferSize [in]
    輸出緩衝區以位元組為單位的大小。單位為位元組。
lpBytesReturned [out, optional]
    （可選）指向一個變數的指標，該變數接收儲存在輸出緩衝區中的資料的大小。如果輸出緩衝區太小，無法接收任何資料，則GetLastError返回ERROR_INSUFFICIENT_BUFFER,錯誤程式碼122(0x7a)

，此時lpBytesReturned是零。
    如果輸出緩衝區太小而無法儲存所有資料，但可以儲存一些條目，某些驅動程式將返回儘可能多的資料,在這種情況下，呼叫失敗，GetLastError返回ERROR_MORE_DATA,錯誤程式碼234，lpBytesReturned指示接收到的資料量。您的應用程式應該再次使用相同的操作呼叫DeviceIoControl，指定一個新的起點。
    如果lpOverlapped為NULL，則lpBytesReturned不能為NULL。 即使操作沒有返回輸出資料並且lpOutBuffer為NULL，DeviceIoControl也會使用lpBytesReturned。在這樣的操作之後，lpBytesReturned的值是沒有意義的。
    如果lpOverlapped不為NULL，則lpBytesReturned可以為NULL。 如果此引數不為NULL並且操作返回資料，則在重疊操作完成之前，lpBytesReturned是無意義的。要檢索返回的位元組數，請呼叫GetOverlappedResult,如果hDevice與I / O完成埠相關聯，則可以檢索通過呼叫GetQueuedCompletionStatus返回的位元組數。
lpOverlapped [in, out, optional]
    （可選）指向OVERLAPPED結構的指標,
如果在未指定FILE_FLAG_OVERLAPPED的情況下開啟hDevice，則忽略lpOverlapped。
如果使用FILE_FLAG_OVERLAPPED標誌開啟hDevice，則該操作將作為重疊（非同步）操作執行。在這種情況下，lpOverlapped必須指向包含事件物件控制代碼的有效OVERLAPPED結構。 否則，該功能將以不可預知的方式失敗。
    對於重疊操作，DeviceIoControl會立即返回，並在操作完成時通知事件物件。 否則，該功能在操作完成或發生錯誤之前不會返回。


返回值:
    如果操作成功完成，DeviceIoControl將返回一個非零值。

    如果操作失敗或正在等待，則DeviceIoControl返回零。 要獲得擴充套件的錯誤資訊，請呼叫GetLastError。

備註:
    要檢索裝置控制代碼，必須使用裝置名稱或與裝置關聯的驅動程式名稱來呼叫CreateFile函式。 要指定裝置名稱，請使用以下格式：
\\.\DeviceName

DeviceIoControl可以接受特定裝置的控制代碼。 對於硬碟來說，可能為以下幾種形式：

對於物理驅動器x，形式為 \\.\PhysicalDriveX ，編號從0開始，例如：

名稱	含義
\\.\PhysicalDrive0	開啟第一個物理驅動器
\\.\PhysicalDrive1	開啟第二個物理驅動器

對於邏輯分割槽（卷），形式為 \\.\X: ，例如：

名稱	含義
\\.\A:	開啟A盤（軟碟機）
\\.\C:	開啟C盤（磁碟邏輯分割槽）

    呼叫CreateFile開啟裝置驅動程式的控制代碼時，應指定FILE_SHARE_READ和FILE_SHARE_WRITE訪問標誌。但是，當您開啟通訊資源（如串列埠）時，必須指定獨佔訪問許可權。 開啟裝置控制代碼時使用其他CreateFile引數，如下所示：
     (a)fdwCreate引數必須指定OPEN_EXISTING。
     (b)hTemplateFile引數必須為NULL。

    (c)fdwAttrsAndFlags引數可指定FILE_FLAG_OVERLAPPED，以指示返回的控制代碼可用於重疊（非同步）I / O操作。

有關支援的控制程式碼列表，請參閱以下主題：
    Communications Control Codes
    Device Management Control Codes
    Directory Management Control Codes
    Disk Management Control Codes
    File Management Control Codes
    Power Management Control Codes
    Volume Management Control Codes


例項：
    有關使用DeviceIoControl的示例，請參閱呼叫DeviceIoControl。


其他連結：

                                                                                                                          Wen Lee

                                                                                                                         2018.04.28