다음을 통해 공유


NTFS_VOLUME_DATA_BUFFER 구조체(winioctl.h)

볼륨 데이터를 나타냅니다. 이 구조체는 FSCTL_GET_NTFS_VOLUME_DATA 제어 코드에 전달됩니다.

구문

typedef struct {
  LARGE_INTEGER VolumeSerialNumber;
  LARGE_INTEGER NumberSectors;
  LARGE_INTEGER TotalClusters;
  LARGE_INTEGER FreeClusters;
  LARGE_INTEGER TotalReserved;
  DWORD         BytesPerSector;
  DWORD         BytesPerCluster;
  DWORD         BytesPerFileRecordSegment;
  DWORD         ClustersPerFileRecordSegment;
  LARGE_INTEGER MftValidDataLength;
  LARGE_INTEGER MftStartLcn;
  LARGE_INTEGER Mft2StartLcn;
  LARGE_INTEGER MftZoneStart;
  LARGE_INTEGER MftZoneEnd;
} NTFS_VOLUME_DATA_BUFFER, *PNTFS_VOLUME_DATA_BUFFER;

멤버

VolumeSerialNumber

볼륨의 일련 번호입니다. 운영 체제에서 볼륨 미디어에 할당한 고유 번호입니다.

NumberSectors

지정된 볼륨의 섹터 수입니다.

TotalClusters

지정된 볼륨에서 사용된 클러스터와 사용이 해제된 클러스터의 수입니다.

FreeClusters

지정된 볼륨의 무료 클러스터 수입니다.

TotalReserved

지정된 볼륨의 예약된 클러스터 수입니다.

BytesPerSector

지정된 볼륨의 섹터에 있는 바이트 수입니다.

BytesPerCluster

지정된 볼륨의 클러스터에 있는 바이트 수입니다. 이 값을 클러스터 요소라고도 합니다.

BytesPerFileRecordSegment

파일 레코드 세그먼트의 바이트 수입니다.

ClustersPerFileRecordSegment

파일 레코드 세그먼트의 클러스터 수입니다.

MftValidDataLength

마스터 파일 테이블의 길이(바이트)입니다.

MftStartLcn

마스터 파일 테이블의 시작 논리 클러스터 번호입니다.

Mft2StartLcn

마스터 파일 테이블 미러의 시작 논리 클러스터 번호입니다.

MftZoneStart

마스터 파일 테이블 영역의 시작 논리 클러스터 번호입니다.

MftZoneEnd

마스터 파일 테이블 영역의 끝 논리 클러스터 번호입니다.

설명

예약된 클러스터는 Windows에서 나중에 사용할 수 있게 예약된 무료 클러스터입니다.

NTFS_VOLUME_DATA_BUFFER 구조체는 FSCTL_GET_NTFS_VOLUME_DATA 반환된 기본 정보를 나타냅니다. 확장 볼륨 정보의 경우 NTFS_VOLUME_DATA_BUFFER 및 NTFS_EXTENDED_VOLUME_DATA 구조체의 결합된 크기인 버퍼를 전달합니다. 성공하면 FSCTL_GET_NTFS_VOLUME_DATA 반환된 버퍼에는 두 구조체와 관련된 정보가 포함됩니다. NTFS_VOLUME_DATA_BUFFER 구조체는 버퍼의 시작 부분에서 시작하여 항상 채워집니다. NTFS_EXTENDED_VOLUME_DATA 구조체는 바로 다음에 표시됩니다. NTFS_EXTENDED_VOLUME_DATA 구조체는 다음과 같이 정의됩니다.

C++
typedef struct {
    ULONG ByteCount;
    USHORT MajorVersion;
    USHORT MinorVersion;
} NTFS_EXTENDED_VOLUME_DATA, *PNTFS_EXTENDED_VOLUME_DATA;
이 구조체에는 NTFS 볼륨에 대한 주 버전 및 부 버전 정보가 포함됩니다. ByteCount 멤버는 FSCTL_GET_NTFS_VOLUME_DATA 호출하여 이 구조에 사용되는 출력 버퍼의 총 바이트를 반환합니다. 이 값은 전달된 버퍼가 버퍼를 보유할 수 있을 만큼 큰 경우여야 합니다 sizeof(NTFS_EXTENDED_VOLUME_DATA) . 그렇지 않으면 값이 보다 sizeof(NTFS_EXTENDED_VOLUME_DATA)작습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)

추가 정보

FSCTL_GET_NTFS_VOLUME_DATA