Metode IVdsAdvancedDisk::FormatPartition (vds.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Memformat OEM, ESP, atau partisi yang tidak diketahui yang ada.
Sintaks
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
);
Parameter
[in] ullOffset
Offset partisi.
[in] type
Nilai enumerasi VDS_FILE_SYSTEM_TYPE yang menentukan sistem file yang akan digunakan. Harus salah satu hal berikut: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, atau VDS_FST_UDF.
[in] pwszLabel
String yang mewakili label volume.
[in] dwUnitAllocationSize
Ukuran unit alokasi untuk sistem file dalam byte, yang biasanya antara 512 dan 65536.
[in] bForce
Jika TRUE, partisi diformat bahkan saat digunakan; jika tidak, operasi gagal.
[in] bQuickFormat
Jika TRUE, VDS melakukan format cepat. Format cepat tidak memverifikasi setiap sektor pada volume.
[in] bEnableCompression
Jika TRUE, mengaktifkan pemadatan pada sistem file yang baru diformat. Kompresi adalah fitur NTFS dan tidak dapat diatur untuk sistem file FAT dan FAT32.
[out] ppAsync
Alamat penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan penunjuk ini untuk membatalkan, menunggu, atau mengkueri status operasi.
Mengembalikan nilai
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.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Partisi berhasil diformat. |
|
Disk dapat dilepas, atau partisi bukan jenis OEM, ESP, atau tidak diketahui. |
|
Partisi tidak ada. |
Keterangan
VDS mengimplementasikan metode ini.
Metode ini hanya memformat OEM, ESP, dan partisi yang tidak diketahui. Untuk partisi lain, Anda harus memformat volume yang sesuai dengan menggunakan metode IVdsVolumeMF::Format atau IVdsVolumeMF2::FormatEx . Perhatikan bahwa OEM, ESP, dan partisi yang tidak diketahui tidak diekspos sebagai volume dan oleh karena itu tidak dapat diformat dengan Format atau FormatEx.
Metode ini tidak dapat digunakan untuk memformat media yang dapat dilepas.
Untuk informasi tentang batas sistem file seperti ukuran unit alokasi minimum dan maksimum (juga disebut ukuran kluster), lihat Referensi Teknis NTFS dan Referensi Teknis FAT.
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | vds.h |
Pustaka | Uuid.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk