Metode IVdsVolumeMF2::FormatEx (vds.h)

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Memformat volume sistem file pada partisi.

Sintaks

HRESULT FormatEx(
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  BOOL      bForce,
  [in]  BOOL      bQuickFormat,
  [in]  BOOL      bEnableCompression,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] pwszFileSystemTypeName

String Unicode yang dihentikan null yang berisi nama sistem file untuk memformat volume. Parameter ini bisa NULL atau nama sistem file Windows. Sistem file berikut didukung: "NTFS", "FAT", "FAT32", "UDF", dan "EXFAT". Jika parameter ini NULL, sistem file default akan digunakan. Untuk informasi selengkapnya, lihat VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

Revisi sistem file, jika ada. Anggota ini dinyatakan sebagai angka desimal berkode biner 16-bit, di mana titik desimal tersirat antara digit kedua dan ketiga. Misalnya, nilai 0x0250 menunjukkan revisi 2,50.

[in] ulDesiredUnitAllocationSize

Ukuran unit alokasi untuk sistem file, dalam byte. Nilai haruslah kekuatan 2. Jika nilainya adalah 0, unit alokasi default yang ditentukan oleh jenis sistem file akan digunakan. Rentang unit alokasi bergantung pada sistem file.

[in] pwszLabel

Untai (karakter) Unicode yang dihentikan null untuk ditetapkan ke sistem file baru. Ukuran label maksimum tergantung pada sistem file.

[in] bForce

Boolean yang menentukan apakah format sistem file dipaksakan, terlepas dari apakah partisi sedang digunakan.

[in] bQuickFormat

Boolean yang menentukan apakah volume sistem file diformat cepat. Format cepat tidak memverifikasi setiap sektor pada volume.

[in] bEnableCompression

Boolean yang menentukan apakah volume sistem file akan dibuat dengan pemadatan diaktifkan.

[out] ppAsync

Arahkan ke antarmuka IVdsAsync yang setelah berhasil diselesaikan menerima antarmuka IVdsAsync untuk memantau dan mengontrol operasi ini. Penelepon harus merilis antarmuka yang diterima ketika mereka selesai dengannya.

Nilai kembali

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Selain itu, antarmuka IVdsAsync dapat mengembalikan peringatan dan kode kesalahan terkait berikut:

Keterangan

Jika partisi OEM diformat sebagai FAT atau FAT32, jenis partisi tidak berubah. Jika diformat dengan NTFS, jenis partisi berubah menjadi PARTITION_IFS (0x07). Untuk informasi tentang jenis partisi, lihat CREATE_PARTITION_PARAMETERS.

Jika metode ini dipanggil untuk volume yang dilindungi oleh enkripsi volume penuh BitLocker, enkripsi BitLocker dinonaktifkan untuk volume hingga pengguna mengaktifkannya kembali.

Untuk informasi selengkapnya tentang batas sistem file seperti ukuran unit alokasi minimum dan maksimum (juga disebut ukuran kluster), lihat Referensi Teknis NTFS dan Referensi Teknis FAT.

Persyaratan

Lihat juga

IVdsVolumeMF2