KsSetInformationFile 函数 (ks.h)

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