IoCreateStreamFileObjectLite 函数 (ntifs.h)
IoCreateStreamFileObjectLite 例程创建新的流文件对象，但不会导致将IRP_MJ_CLEANUP请求发送到文件系统驱动程序堆栈。
语法
PFILE_OBJECT IoCreateStreamFileObjectLite(
[in, optional] PFILE_OBJECT FileObject,
[in, optional] PDEVICE_OBJECT DeviceObject
);
参数
[in, optional] FileObject
指向新流文件所关联的文件对象的指针。 此参数是可选的，可以为 NULL。
[in, optional] DeviceObject
指向要打开流文件的设备的设备对象的指针。 如果调用方为 FileObject 指定非 NULL 值，则忽略 DeviceObject 的值。 否则，调用方必须为 DeviceObject 指定非 NULL 值。
返回值
IoCreateStreamFileObjectLite 返回指向新创建的流文件对象的指针。
注解
文件系统调用 IoCreateStreamFileObjectLite 以创建新的流文件对象。 流文件对象与普通文件对象相同，只不过设置了FO_STREAM_FILE文件对象标志。
流文件对象通常用于表示文件系统装载的卷的内部流。 此 虚拟卷文件 允许文件系统查看、更改和缓存卷的磁盘结构，就像它是一个普通文件一样。 在这种情况下，调用 IoCreateStreamFileObjectLite 中的 DeviceObject 参数指定卷的卷设备对象 (VDO) 。
流文件对象还可用于表示用于访问已打开文件的元数据（如扩展属性或安全描述符）的备用数据流。 在这种情况下，对 IoCreateStreamFileObjectLite 的调用中的 FileObject 参数指定文件的现有文件对象。 新创建的流文件对象允许文件系统查看、更改和缓存文件的元数据，就像它是一个普通文件一样。
当不再需要流文件对象时，调用方必须通过调用 ObDereferenceObject 来递减其引用计数。 当流文件对象的引用计数达到零时，会将IRP_MJ_CLOSE请求发送到卷的文件系统驱动程序堆栈。
文件系统筛选器驱动程序编写者应注意，与 IoCreateStreamFileObject 不同， IoCreateStreamFileObjectLite 不会导致将IRP_MJ_CLEANUP请求发送到文件系统驱动程序堆栈。 因此，由于文件系统通常创建流文件对象作为除IRP_MJ_CREATE以外的操作的副作用，因此筛选器驱动程序很难可靠地检测流文件对象的创建。 因此，筛选器驱动程序应接收以前未看到的文件对象的IRP_MJ_CLOSE请求。
如果池分配失败， IoCreateStreamFileObjectLite 将引发STATUS_INSUFFICIENT_RESOURCES异常。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 |
| 目标平台 | 通用 |
| 标头 | ntifs.h (包括 Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |