IRP_MJ_SET_EA (FS 和筛选器驱动程序)

项目
02/02/2024

发送时间

I/O 管理器发送IRP_MJ_SET_EA请求来设置文件的扩展属性。

操作：文件系统驱动程序

如果文件系统支持扩展属性，则文件系统驱动程序应处理请求并完成 IRP。否则，文件系统驱动程序应返回 STATUS_EAS_NOT_SUPPORTED。

操作：旧版文件系统筛选器驱动程序

筛选器驱动程序应将此 IRP 向下传递到堆栈上下一个较低的驱动程序。

参数

文件系统或筛选器驱动程序调用给定 IRP 的 IoGetCurrentIrpStackLocation ，以获取指向 IRP 中其自身堆栈位置的指针。在以下参数中， Irp 指向 IRP ， 而 IrpSp 指向 IO_STACK_LOCATION。驱动程序可以使用在 IRP 的以下成员和 IRP 堆栈位置中设置的信息来处理一组扩展属性请求：

DeviceObject 是指向目标设备对象的指针。
Irp->AssociatedIrp.SystemBuffer 指向系统提供的输入缓冲区，该缓冲区包含要设置的扩展属性信息。用于METHOD_BUFFERED I/O。
Irp->IoStatus 指向一个 IO_STATUS_BLOCK 结构，该结构接收最终完成状态和有关所请求操作的信息。
Irp->MdlAddress 是内存描述符列表的地址， (MDL) 描述接收扩展属性信息的输入缓冲区。用于METHOD_DIRECT I/O。
Irp->UserBuffer 指向调用方提供的 FILE_FULL_EA_INFORMATION结构化输入缓冲区，该缓冲区接收扩展属性信息。用于METHOD_NEITHER I/O。
IrpSp->FileObject 指向与 DeviceObject 关联的文件对象。

IrpSp-FileObject> 参数包含指向 RelatedFileObject 字段的指针，该字段也是FILE_OBJECT结构。 FILE_OBJECT 结构的 RelatedFileObject 字段在处理IRP_MJ_SET_EA期间无效，不应使用。
IrpSp->MajorFunction 设置为 IRP_MJ_SET_EA。
IrpSp->Parameters.SetEa.Length 是输入缓冲区的长度（以字节为单位）。