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 구조 뒤에 있는 파일 레이아웃 항목은 FSCTL_QUERY_FILE_LAYOUT요청에 대한 입력으로 제공된 QUERY_FILE_LAYOUT_INPUTFlags 멤버에 설정된 플래그에 의해 결정됩니다. 여러 FILE_LAYOUT_ENTRY 구조체가 QUERY_FILE_LAYOUT_OUTPUT 따릅니다. 쿼리에서 반환하도록 선택한 항목에 따라 FILE_LAYOUT_ENTRY 오프셋은 추가 정보 항목이 사용자 버퍼에 있는 위치를 나타냅니다.

해당 포함 플래그가 QUERY_FILE_LAYOUT_INPUTFlags 멤버에 설정되면 다음 항목 구조가 반환됩니다.

입력 포함 플래그
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