共用方式為

QUERY_FILE_LAYOUT_OUTPUT結構 （ntifs.h）

  • 發行項

QUERY_FILE_LAYOUT_OUTPUT 結構可作為從 FSCTL_QUERY_FILE_LAYOUT 要求傳回之檔案配置項目的標頭。

語法

typedef struct _QUERY_FILE_LAYOUT_OUTPUT {
  ULONG FileEntryCount;
  ULONG FirstFileOffset;
  ULONG Flags;
  ULONG Reserved;
} QUERY_FILE_LAYOUT_OUTPUT, *PQUERY_FILE_LAYOUT_OUTPUT;

成員

FileEntryCount

在這個結構之後的檔案項目數目。

FirstFileOffset

用戶緩衝區中第一個檔案專案的位移。

Flags

指出傳回的配置專案格式。 可以是 0 或下列專案：

價值 意義
QUERY_FILE_LAYOUT_SINGLE_INSTANCED
 會傳回數據流和檔案配置專案的單一實例。 設定時，每個數據流只會傳回一個 STREAM_LAYOUT_ENTRY 結構，而且每個檔案只會傳回一個 FILE_LAYOUT_ENTRY 結構。 此旗標一律為NTFS設定。

Reserved

保留。

言論

在 QUERY_FILE_LAYOUT_OUTPUT 結構後面的檔案配置專案是由 Flags 中設定的旗標， 成員 QUERY_FILE_LAYOUT_INPUT 做為 FSCTL_QUERY_FILE_LAYOUT 要求的輸入所決定。 一些 FILE_LAYOUT_ENTRY 結構遵循 QUERY_FILE_LAYOUT_OUTPUT。 根據選取要從查詢傳回的專案而定，FILE_LAYOUT_ENTRY 中的位移會指出用戶緩衝區中其他參考專案的位置。

在 QUERY_FILE_LAYOUT_INPUT的 旗標 成員中設定對應的包含旗標時，會傳回下列項目結構。

進入 包含旗標
FILE_LAYOUT_NAME_ENTRY QUERY_FILE_LAYOUT_INCLUDE_NAMES
FILE_LAYOUT_INFO_ENTRY QUERY_FILE_LAYOUT_INCLUDE_EXTRA_INFO
STREAM_LAYOUT_ENTRY QUERY_FILE_LAYOUT_INCLUDE_STREAMS
STREAM_EXTENT_ENTRY QUERY_FILE_LAYOUT_INCLUDE_EXTENTS
 

當單一 FILE_LAYOUT_ENTRY 結構有多個相同類型的專案存在時，每個參考項目結構都有一個位移成員，指出下一個專案的位置。 項目結構的鏈結會繼續，直到位移成員的值是 0 為止。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
標頭 ntifs.h （include Ntifs.h）

另請參閱

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT