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檔案物件執行作業。

規格需求

需求	值
目標平台	Universal
標頭	ks.h (包含 Ks.h)
程式庫	Ks.lib