通过

KsQueryInformationFile 函数 (ks.h)

  • 项目

KsQueryInformationFile 函数针对指定的文件对象执行信息查询。 如果可能，函数会尝试使用 FastIoDispatch ，或者针对设备对象生成信息请求。

语法

KSDDKAPI NTSTATUS KsQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

参数

[in] FileObject

指定要从中查询标准信息的文件对象。

[out] FileInformation

指示放置文件信息的位置。 假定这是有效的或探测的地址。

[in] Length

指定 FileInformation 缓冲区的正确长度。

[in] FileInformationClass

指定要请求的信息的类。

返回值

如果成功， KsQueryInformationFile 函数将返回STATUS_SUCCESS，如果失败，则返回查询错误。

注解

KsQueryInformationFile 函数仅应在查询导致对基础驱动程序的实际请求的情况下使用。 例如， FilePositionInformation 不会生成此类请求，也不应使用。 它假定调用方正在序列化对文件的访问权限，以便针对FO_SYNCHRONOUS_IO文件对象执行操作。

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib