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文件对象执行操作。

要求