FltFsControlFile 函式（fltkernel.h）

發行項
02/06/2025

FltFsControlFile 例程會將控件程式代碼直接傳送至指定的檔案系統或文件系統篩選驅動程式，導致對應的驅動程式執行指定的動作。

語法

NTSTATUS FLTAPI FltFsControlFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [in]            ULONG         FsControlCode,
  [in, optional]  PVOID         InputBuffer,
  [in]            ULONG         InputBufferLength,
  [out, optional] PVOID         OutputBuffer,
  [in]            ULONG         OutputBufferLength,
  [out, optional] PULONG        LengthReturned
);

參數

[in] Instance

呼叫端的不透明實例指標。這是必要參數，而且無法 NULL。

[in] FileObject

此要求目標之檔案或目錄的檔案物件指標。這是必要參數，而且無法 NULL。

[in] FsControlCode

FSCTL_XXX 程式代碼，指出要執行的文件系統作業。此參數的值會決定 InputBuffer 和 OutputBuffer的格式和必要長度，並判斷下列哪一個參數位（需要 InputBuffer 和 InputBufferLength、OutputBuffer 和 OutputBufferLength）。

[in, optional] InputBuffer

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

[in] InputBufferLength

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

[out, optional] OutputBuffer

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

[in] OutputBufferLength

OutputBuffer緩衝區的大小，以位元組為單位。如果 outputBuffer NULL，則會忽略此值。

[out, optional] LengthReturned

呼叫端配置的變數指標，該變數會接收緩衝區中所傳回資訊的大小，以位元組為單位，OutputBuffer。這個參數是選擇性的，而且可以 NULL。