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

另請參閱

FltFsControlFile