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 |