ioCreateStreamFileObject 函数 (ntifs.h)

IoCreateStreamFileObject 例程创建一个新的流文件对象。

语法

PFILE_OBJECT IoCreateStreamFileObject(
  [in, optional] PFILE_OBJECT   FileObject,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

参数

[in, optional] FileObject

指向与新流文件相关的文件对象的指针。 此参数是可选的,可为 NULL

[in, optional] DeviceObject

指向要打开流文件的设备的设备对象的指针。 如果调用方为 FileObject 指定非 NULL 值,则忽略 DeviceObject 的值。 否则,调用方必须为 DeviceObject 指定非 NULL 值。

返回值

IoCreateStreamFileObject 返回指向新创建的流文件对象的指针。

备注

文件系统调用 IoCreateStreamFileObject 以创建新的流文件对象。 流文件对象与普通文件对象相同,但设置了FO_STREAM_FILE文件对象标志。

流文件对象通常用于表示文件系统装载的卷的内部流。 此 虚拟卷文件 允许文件系统查看、更改和缓存卷的磁盘结构,就像它是普通文件一样。 在这种情况下,对 IoCreateStreamFileObject 的调用中的 DeviceObject 参数指定卷设备对象 (VDO) 卷。

流文件对象还可用于表示用于访问文件的元数据的备用数据流,例如扩展属性或安全描述符。 在这种情况下,对 IoCreateStreamFileObject 的调用中的 FileObject 参数指定文件的现有文件对象。 新创建的流文件对象允许文件系统查看、更改和缓存文件的元数据,就像它是普通文件一样。

不再需要流文件对象时,调用方必须通过调用 ObDereferenceObject 递减其引用计数。 当流文件对象的引用计数达到零时,会将IRP_MJ_CLOSE请求发送到卷的文件系统驱动程序堆栈。

文件系统筛选器驱动程序编写器应注意 ,IoCreateStreamFileObject 会导致将IRP_MJ_CLEANUP请求发送到卷的文件系统驱动程序堆栈。 由于文件系统通常创建流文件对象作为除IRP_MJ_CREATE以外的操作的副作用,因此筛选器驱动程序很难可靠地检测流文件对象的创建。 因此,筛选器驱动程序应会收到以前未见的文件对象的IRP_MJ_CLEANUP和IRP_MJ_CLOSE请求。

如果池分配失败, IoCreateStreamFileObject 将引发STATUS_INSUFFICIENT_RESOURCES异常。

要求

   
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另请参阅

IRP_MJ_CLEANUP

IRP_MJ_CLOSE

IRP_MJ_CREATE

IoCreateStreamFileObjectEx

IoCreateStreamFileObjectLite

ObDereferenceObject