FltDeviceIoControlFile 函式 (fltkernel.h)
FltDeviceIoControlFile 會將控件程式代碼直接傳送至指定的設備驅動器,導致對應的驅動程式執行指定的動作。
語法
NTSTATUS FLTAPI FltDeviceIoControlFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[in] ULONG IoControlCode,
[in, optional] PVOID InputBuffer,
[in] ULONG InputBufferLength,
[out] PVOID OutputBuffer,
[in] ULONG OutputBufferLength,
[out, optional] PULONG LengthReturned
);
參數
[in] Instance
呼叫端的不透明實例指標。 這個參數是必要的,而且不能是 NULL。
[in] FileObject
此要求目標之檔案或裝置的檔案物件指標。 這個參數是必要的,而且不能是 NULL。
[in] IoControlCode
IOCTL_XXX 程式代碼,指出要執行的裝置 I/O 作業。此參數的值會決定 InputBuffer 和 OutputBuffer 的格式和必要長度,並決定下列哪一個參數位 (InputBuffer 和 InputBufferLength,或 OutputBufferLength 和 OutputBufferLength) 。
[in, optional] InputBuffer
呼叫端配置的輸入緩衝區指標,其中包含要提供給目標驅動程式的裝置特定資訊。 如果 IoControlCode 參數指定不需要輸入資料的作業,這個參數是選擇性的,而且可以是 NULL。
[in] InputBufferLength
InputBuffer 緩衝區的大小,以位元組為單位。 如果 InputBuffer 為 NULL,則會忽略此值。
[out] OutputBuffer
呼叫端配置的輸出緩衝區指標,其中會從目標驅動程式傳回資訊。 如果 IoControlCode 參數指定不需要輸出資料的作業,這個參數是選擇性的,而且可以是 NULL。
[in] OutputBufferLength
在 OutputBuffer 緩衝區的大小,以位元組為單位。 如果 OutputBuffer 為 NULL,則會忽略此值。
[out, optional] LengthReturned
呼叫端配置的變數指標,該變數會接收 在 OutputBuffer 緩衝區中傳回之資訊的大小,以位元組為單位。 此參數是選擇性的,可以是 NULL。
傳回值
FltDeviceIoControlFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值。
備註
如需系統定義IOCTL_XXX 程式代碼的詳細資訊,請參閱 Microsoft Windows SDK 檔中DeviceIoControl參考專案的一節。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | fltkernel.h (包含 Fltkernel.h) |
程式庫 | FltMgr.lib |
IRQL | PASSIVE_LEVEL |