FltFsControlFile 函数 (fltkernel.h)

项目
02/29/2024

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 处缓冲区的大小（以字节为单位）。如果 InputBuffer 为 NULL，则忽略此值。

[out, optional] OutputBuffer

指向调用方分配的输出缓冲区的指针，在该缓冲区中从目标驱动程序返回信息。如果 FsControlCode 参数指定的操作不需要输出数据，则此参数是可选的，可以为 NULL。

[in] OutputBufferLength

OutputBuffer 处缓冲区的大小（以字节为单位）。如果 OutputBuffer 为 NULL，则忽略此值。

[out, optional] LengthReturned

指向调用方分配的变量的指针，该变量接收 OutputBuffer 缓冲区中返回的信息的大小（以字节为单位）。此参数是可选的，可以为 NULL。