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

規格需求

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