共用方式為

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