NtDeviceIoControlFile 函式 （ntifs.h）
ZwDeviceIoControlFile 例程會將控制程式代碼直接傳送至指定的設備驅動器，導致對應的驅動程式執行指定的作業。
語法
__kernel_entry NTSYSCALLAPI NTSTATUS NtDeviceIoControlFile(
[in] HANDLE FileHandle,
[in, optional] HANDLE Event,
[in, optional] PIO_APC_ROUTINE ApcRoutine,
[in, optional] PVOID ApcContext,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] ULONG IoControlCode,
[in, optional] PVOID InputBuffer,
[in] ULONG InputBufferLength,
[out, optional] PVOID OutputBuffer,
[in] ULONG OutputBufferLength
);
參數
[in] FileHandle
ZwCreateFile或 ZwOpenFile 所傳回的檔案物件，ZwCreateFile 所傳回的句柄，此物件代表應為其提供控件資訊的裝置，或從中傳回哪些資訊。 如果呼叫端指定 事件、ApcRoutine，以及 APC 內容（ApcContext），或完成內容（ApcContext），則檔案對象必須已針對異步 I/O 開啟。 對於基礎大量儲存裝置的 I/O，檔案物件必須已開啟，才能直接存取記憶體裝置 （DASD） 存取。
[in, optional] Event
呼叫端所建立事件的句柄。 如果提供此參數，呼叫端會進入等候狀態，直到要求作業完成，且指定的事件設定為 Signaled 狀態。 這個參數是選擇性的，而且可以是 NULL。 如果呼叫端將等候 FileHandle 設定為 Signaled 狀態，它必須是 NULL。
[in, optional] ApcRoutine
要求作業完成時要呼叫的選擇性、呼叫端提供的 APC 例程位址。 此參數可以是 NULL。 如果有與檔案對象相關聯的 I/O 完成物件，它必須是 NULL。
[in, optional] ApcContext
呼叫端決定之內容區域的指標。 如果呼叫端提供 APC，這個參數值會當做 APC 內容使用，如果 I/O 完成物件已與檔案對象相關聯，則會當做完成內容使用。 當作業完成時，如果已指定 APC 內容，則 APC 內容會傳遞至 APC，或完成內容包含在 I/O 管理員張貼到相關聯 I/O 完成物件的完成訊息中。
這個參數是選擇性的，而且可以是 NULL。 如果 ApcRoutine 為 NULL，而且沒有與檔案對象相關聯的 I/O 完成物件，它必須是 NULL。
[out] IoStatusBlock
接收最終完成狀態和作業相關信息之變數的指標。 對於傳回數據的成功呼叫，寫入至 OutputBuffer 的位元組數目會在 Information 成員中傳回。
[in] IoControlCode
IOCTL_Xxx 程式代碼，指出要執行哪些裝置 I/O 控制作業，通常是由基礎設備驅動器執行。 此參數的值會決定 InputBuffer 和 OutputBuffer的格式和必要長度，以及下列哪一個參數位是必要的。 如需系統定義、裝置類型特定IOCTL_Xxx 代碼的詳細資訊，請參閱 Microsoft Windows 驅動程式套件 （WDK） 檔案 裝置技術特定一節，以及 裝置輸入和輸出控制碼。
[in, optional] InputBuffer
呼叫端配置的輸入緩衝區指標，其中包含要提供給目標裝置的裝置特定資訊。 如果 IoControlCode 指定不需要輸入資料的作業，此指標可以是 NULL。
[in] InputBufferLength
InputBuffer緩衝區的大小，以位元組為單位。 如果 InputBuffer 為 NULL，請將 InputBufferLength 設為零。
[out, optional] OutputBuffer
呼叫端配置的輸出緩衝區指標，其中會從目標裝置傳回資訊。 如果 IoControlCode 指定不產生輸出資料的作業，此指標可以是 NULL。
[in] OutputBufferLength
OutputBuffer緩衝區的大小，以位元組為單位。 如果 outputBuffer 為 NULL，請將 outputBufferLength 設為零。
傳回值
ZwDeviceIoControlFile 如果基礎驅動程式成功執行要求的作業，則會傳回STATUS_SUCCESS。 否則，傳回值可以是從基礎驅動程式傳播的錯誤狀態代碼。 可能的錯誤狀態代碼包括下列專案：
言論
ZwDeviceIoControlFile 提供系統輸入與輸出數據與內核模式驅動程式的一致檢視，同時為應用程式和基礎驅動程式提供裝置相依方法來指定通訊介面。
如需系統定義IOCTL_Xxx 碼，以及定義驅動程式特定IOCTL_Xxx 或FSCTL_Xxx 值的詳細資訊，請參閱 使用 I/O 控制碼 和 裝置輸入和輸出控制碼。
如果呼叫端開啟了異步 I/O 的檔案（未FILE_SYNCHRONOUS_Xxx 建立/開啟選項集），則指定的事件，如果有的話，會在裝置控制作業完成時設定為訊號狀態。 否則，FileHandle 所指定的檔案物件 會設定為訊號狀態。 如果指定了 ApcRoutine，則會使用 ApcContext 和 IoStatusBlock 指標來呼叫它。
Minifilters 應該使用 FltDeviceIoControlFile，而不是 ZwDeviceIoControlFile。
ZwDeviceIoControlFile 的呼叫端必須在 IRQL = PASSIVE_LEVEL，且 啟用特殊核心 APC。
如果在使用者模式中呼叫 ZwDeviceIoControlFile 函式，您應該使用名稱 “NtDeviceIoControlFile”，而不是 “ZwDeviceIoControlFile”。
對於內核模式驅動程式的呼叫，NtXxx 和 ZwXxx 版本的 Windows 原生系統服務例程，在處理和解譯輸入參數的方式上可能會有不同的行為。 如需 nt NtXxx 與 ZwXxx 例程之間關聯性的詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 目標平臺 | 普遍 |
| 標頭 | ntifs.h （include Ntifs.h， Ntddk.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL （請參閱一節） |
| DDI 合規性規則 | HwStorPortProhibitedDDIs， PowerIrpDDis |