KsSetInformationFile 函数针对指定的文件对象执行信息集。 函数尝试尽可能使用 FastIoDispatch,或者针对设备对象生成信息集。
语法
KSDDKAPI NTSTATUS KsSetInformationFile(
[in] PFILE_OBJECT FileObject,
[in] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
参数
[in] FileObject
指定要设置标准信息的文件对象。
[in] FileInformation
指示放置文件信息的位置。 文件信息假定为有效地址或探测地址。
[in] Length
指定 FileInformation 缓冲区的正确长度。
[in] FileInformationClass
指定要设置的信息类。
返回值
KsSetInformationFile 函数返回STATUS_SUCCESS如果成功,或者返回设置错误,则返回失败。
言论
仅当集会导致向基础驱动程序发出实际请求时,才应使用 KsSetInformationFile 函数,不包括需要将其他参数发送到驱动程序的复杂作,例如重命名、删除和完成。 例如,FilePositionInformation 不会生成此类请求,不应使用。 它假定调用方正在序列化对文件的访问权限,以便针对FO_SYNCHRONOUS_IO文件对象执行作。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | ks.h (包括 Ks.h) |
库 | Ks.lib |