다음을 통해 공유


IVdsAdvancedDisk::FormatPartition 메서드(vds.h)

[Windows 8 및 Windows Server 2012 가상 디스크 서비스 COM 인터페이스는 Windows Storage 관리 API로 대체됩니다.]

기존 OEM, ESP 또는 알 수 없는 파티션의 형식을 지정합니다.

구문

HRESULT FormatPartition(
  [in]  ULONGLONG            ullOffset,
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

매개 변수

[in] ullOffset

파티션 오프셋입니다.

[in] type

사용할 파일 시스템을 지정하는 VDS_FILE_SYSTEM_TYPE 열거형 값입니다. VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 또는 VDS_FST_UDF 중 하나여야 합니다.

[in] pwszLabel

볼륨 레이블을 나타내는 문자열입니다.

[in] dwUnitAllocationSize

일반적으로 512에서 65536 사이인 파일 시스템의 할당 단위 크기(바이트)입니다.

[in] bForce

TRUE이면 사용 중인 경우에도 파티션의 형식이 지정됩니다. 그렇지 않으면 작업이 실패합니다.

[in] bQuickFormat

TRUE이면 VDS가 빠른 형식을 수행합니다. 빠른 형식은 볼륨의 각 섹터를 확인하지 않습니다.

[in] bEnableCompression

TRUE이면 새로 포맷된 파일 시스템에서 압축을 사용하도록 설정합니다. 압축은 NTFS의 기능이며 FAT 및 FAT32 파일 시스템에 대해 설정할 수 없습니다.

[out] ppAsync

반환 시 VDS가 초기화하는 IVdsAsync 인터페이스 포인터의 주소입니다. 호출자는 인터페이스를 해제해야 합니다. 이 포인터를 사용하여 작업의 상태 취소, 대기 또는 쿼리합니다.

반환 값

이 메서드는 E_INVALIDARG 또는 E_OUTOFMEMORY 같은 표준 HRESULT 값과 VDS별 반환 값을 반환할 수 있습니다. HRESULT_FROM_WIN32 매크로를 사용하여 변환된 시스템 오류 코드를 반환할 수도 있습니다. 오류는 VDS 자체 또는 사용 중인 기본 VDS 공급자 에서 발생할 수 있습니다. 가능한 반환 값은 다음과 같습니다.

반환 코드/값 Description
S_OK
파티션의 형식이 성공적으로 지정되었습니다.
VDS_E_INVALID_OPERATION
0x80042415L
디스크가 이동식이거나 파티션이 OEM, ESP 또는 알 수 없는 형식이 아닙니다.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
파티션이 없습니다.

설명

VDS는 이 메서드를 구현합니다.

이 메서드는 OEM, ESP 및 알 수 없는 파티션만 서식을 지정합니다. 다른 파티션의 경우 대신 IVdsVolumeMF::Format 또는 IVdsVolumeMF2::FormatEx 메서드를 사용하여 해당 볼륨의 서식을 지정해야 합니다. OEM, ESP 및 알 수 없는 파티션은 볼륨으로 노출되지 않으므로 Format 또는 FormatEx로 형식을 지정할 수 없습니다.

이 메서드는 이동식 미디어의 서식을 지정하는 데 사용할 수 없습니다.

최소 및 최대 할당 단위 크기(클러스터 크기라고도 함)와 같은 파일 시스템 제한에 대한 자세한 내용은 NTFS 기술 참조FAT 기술 참조를 참조하세요.

OEM 파티션의 형식이 FAT 또는 FAT32인 경우 파티션 형식은 변경되지 않습니다. NTFS로 포맷된 경우 파티션 형식이 PARTITION_IFS(0x07)로 변경됩니다. 파티션 형식에 대한 자세한 내용은 CREATE_PARTITION_PARAMETERS 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vds.h
라이브러리 Uuid.lib

추가 정보

Disk 개체

IVdsAdvancedDisk

IVdsAsync

IVdsDiskPartitionMF::FormatPartitionEx

VDS_FILE_SYSTEM_TYPE