Partager via


Méthode IVdsAdvancedDisk ::FormatPartition (vds.h)

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Met en forme une partition OEM, ESP ou inconnue existante.

Syntaxe

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
);

Paramètres

[in] ullOffset

Décalage de partition.

[in] type

Valeur d’énumération VDS_FILE_SYSTEM_TYPE qui spécifie le système de fichiers à utiliser. Doit être l’une des suivantes : VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF.

[in] pwszLabel

Chaîne représentant l’étiquette du volume.

[in] dwUnitAllocationSize

Taille de l’unité d’allocation pour le système de fichiers en octets, qui est généralement comprise entre 512 et 65536.

[in] bForce

Si la valeur est TRUE, la partition est mise en forme même en cours d’utilisation ; sinon, l’opération échoue.

[in] bQuickFormat

Si la valeur est TRUE, VDS effectue un format rapide. Un format rapide ne vérifie pas chaque secteur sur le volume.

[in] bEnableCompression

Si la valeur est TRUE, active la compression sur le système de fichiers nouvellement mis en forme. La compression est une fonctionnalité de NTFS et ne peut pas être définie pour les systèmes de fichiers FAT et FAT32.

[out] ppAsync

Adresse d’un pointeur d’interface IVdsAsync , que VDS initialise au retour. Les appelants doivent libérer l’interface. Utilisez ce pointeur pour annuler, attendre ou interroger le status de l’opération.

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour Description
S_OK
La partition a été mise en forme avec succès.
VDS_E_INVALID_OPERATION
0x80042415L
Le disque est amovible ou la partition n’est pas de type OEM, ESP ou inconnu.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
La partition n’existe pas.

Remarques

VDS implémente cette méthode.

Cette méthode met en forme uniquement OEM, ESP et les partitions inconnues. Pour les autres partitions, vous devez mettre en forme le volume correspondant à l’aide de la méthode IVdsVolumeMF ::Format ou IVdsVolumeMF2 ::FormatEx . Notez que les partitions OEM, ESP et inconnues ne sont pas exposées en tant que volumes et ne peuvent donc pas être mises en forme avec Format ou FormatEx.

Cette méthode ne peut pas être utilisée pour mettre en forme un média amovible.

Pour plus d’informations sur les limites du système de fichiers, telles que la taille d’unité d’allocation minimale et maximale (également appelée taille de cluster), consultez Référence technique NTFS et Référence technique FAT.

Si une partition OEM est au format FAT ou FAT32, le type de partition ne change pas. S’il est mis en forme avec NTFS, le type de partition devient PARTITION_IFS (0x07). Pour plus d’informations sur les types de partitions, consultez CREATE_PARTITION_PARAMETERS.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vds.h
Bibliothèque Uuid.lib

Voir aussi

Objet Disk

IVdsAdvancedDisk

IVdsAsync

IVdsDiskPartitionMF ::FormatPartitionEx

VDS_FILE_SYSTEM_TYPE