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

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

進入 包含旗標
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 (包含 Ntifs.h)

另請參閱

FSCTL_QUERY_FILE_LAYOUT

QUERY_FILE_LAYOUT_INPUT