IVdsVolumeMF::Format, méthode (vds.h)

  • Article

[À 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 un système de fichiers sur le volume actif.

Syntaxe

HRESULT Format(
  [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] type

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

[in] pwszLabel

Chaîne représentant l’étiquette du système de fichiers.

[in] dwUnitAllocationSize

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

[in] bForce

Si la valeur est TRUE, le système de fichiers est mis en forme de manière inconditionnelle même en cours d’utilisation ; sinon, l’opération échoue.

[in] bQuickFormat

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

[in] bEnableCompression

Si la valeur est TRUE, la compression est activée sur le système de fichiers nouvellement mis en forme. La compression est une fonctionnalité de NTFS et est ignorée pour 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 l’état 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
 Le système de fichiers a été correctement mis en forme.
VDS_E_OPERATION_DENIED
0x8004240AL
 L’opération est refusée si l’appelant tente de mettre en forme le système, le démarrage, le crashdump, la mise en veille prolongée ou les volumes pagefile.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Le volume a échoué.
VDS_E_PACK_OFFLINE
0x80042444L
 Le pack contenant le volume n’est pas accessible. Tous les volumes d’un pack hors connexion sont inaccessibles.
 

En outre, l’interface IVdsAsync peut retourner les avertissements et codes d’erreur associés suivants.

Code/valeur de retour Description
VDS_S_VOLUME_COMPRESS_FAILED
0x00042443L
 Le système de fichiers est mis en forme, mais pas compressé.
VDS_E_INCOMPATIBLE_FILE_SYSTEM
0x80042425L
 Le système de fichiers n’est pas compatible.
VDS_E_INCOMPATIBLE_MEDIA
0x80042426L
 Le média n’est pas compatible.
VDS_E_ACCESS_DENIED
0x80042427L
 L’accès est refusé.
VDS_E_MEDIA_WRITE_PROTECTED
0x80042428L
 Le média est protégé en écriture.
VDS_E_BAD_LABEL
0x80042429L
 L’étiquette n’est pas valide.
VDS_E_CANT_QUICK_FORMAT
0x8004242AL
 Le volume ne peut pas être mis en forme rapidement.
VDS_E_IO_ERROR
0x8004242BL
 Une erreur d’E/S s’est produite pendant le format.
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
 La taille du volume est trop petite pour être mise en forme.
VDS_E_VOLUME_TOO_BIG
0x8004242DL
 La taille du volume est trop grande pour être mise en forme.
VDS_E_CLUSTER_SIZE_TOO_SMALL
0x8004242EL
 La taille du cluster est trop petite pour permettre la mise en forme.
VDS_E_CLUSTER_SIZE_TOO_BIG
0x8004242FL
 La taille du cluster est trop grande pour permettre la mise en forme.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS
0x80042430L
 Le nombre de clusters est trop grand pour être représenté sous la forme d’un entier 32 bits.
VDS_E_INVALID_FS_TYPE
0x80042561L
 La valeur du paramètre de type n’était pas VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF.
VDS_E_CANT_INVALIDATE_FVE
0x80042592L
 Impossible de désactiver le chiffrement BitLocker pour le volume.

Remarques

Pour créer un volume de démarrage sur un disque dynamique, vous devez appeler IVdsVolume::SetFlags pour définir l’indicateur VDS_VF_INSTALLABLE avant d’appeler Format pour mettre en forme le volume.

Si une partition OEM est mise en forme en 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.

Si cette méthode est appelée pour un volume protégé par le chiffrement de volume complet BitLocker, le chiffrement BitLocker est désactivé pour le volume jusqu’à ce que l’utilisateur le réactive.

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

Configuration requise

   
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

IVdsAsync

IVdsVolumeMF

VDS_FILE_SYSTEM_TYPE