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，或者 OutputBuffer 和 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 参考条目的“备注”部分。

要求

要求 值
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
IRQL PASSIVE_LEVEL

另请参阅

FltFsControlFile