fltFsControlFile 函数 (fltkernel.h)

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 代码,指示要执行哪个文件系统操作。此参数的值确定 InputBufferOutputBuffer 的格式和所需长度,并确定以下哪一个参数对 (InputBufferInputBufferLength、OutputBufferOutputBufferLength) 。

[in, optional] InputBuffer

指向调用方分配的输入缓冲区的指针,该缓冲区包含要提供给目标驱动程序的设备特定信息。 如果 FsControlCode 参数指定不需要输入数据的操作,则此参数是可选的,可以为 NULL

[in] InputBufferLength

InputBuffer 处缓冲区的大小(以字节为单位)。 如果 InputBufferNULL,则忽略此值。

[out, optional] OutputBuffer

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

[in] OutputBufferLength

OutputBuffer 上的缓冲区的大小(以字节为单位)。 如果 OutputBufferNULL,则忽略此值。

[out, optional] LengthReturned

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

返回值

FltFsControlFile 返回STATUS_SUCCESS或适当的 NTSTATUS 值。

注解

微型筛选器驱动程序应调用此例程,而不是 ZwFsControlFile

内核模式驱动程序目前记录了以下 FSCTL 代码:

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_OPBATCH_ACK_CLOSE_PENDING

FSCTL_OPLOCK_BREAK_ACK_NO_2

FSCTL_OPLOCK_BREAK_ACKNOWLEDGE

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_BATCH_OPLOCK

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_1

FSCTL_REQUEST_OPLOCK_LEVEL_2

FSCTL_SET_REPARSE_POINT

有关系统定义的FSCTL_XXX 代码的详细信息,请参阅 Microsoft Windows SDK 文档中 DeviceIoControl 参考条目的“备注”部分。

要求

   
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

另请参阅

FltDeviceIoControlFile

ZwFsControlFile