共用方式為


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 作業。此參數的值會決定 InputBufferOutputBuffer 的格式和必要長度,並決定下列哪一個參數位 (InputBufferInputBufferLength,或 OutputBufferLength 和 OutputBufferLength) 。

[in, optional] InputBuffer

呼叫端配置的輸入緩衝區指標,其中包含要提供給目標驅動程式的裝置特定資訊。 如果 IoControlCode 參數指定不需要輸入資料的作業,這個參數是選擇性的,而且可以是 NULL

[in] InputBufferLength

InputBuffer 緩衝區的大小,以位元組為單位。 如果 InputBufferNULL,則會忽略此值。

[out] OutputBuffer

呼叫端配置的輸出緩衝區指標,其中會從目標驅動程式傳回資訊。 如果 IoControlCode 參數指定不需要輸出資料的作業,這個參數是選擇性的,而且可以是 NULL

[in] OutputBufferLength

在 OutputBuffer 緩衝區的大小,以位元組為單位。 如果 OutputBufferNULL,則會忽略此值。

[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

另請參閱

FltFsControlFile