通过

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）
库 Ks.lib