IVdsVolumeMF::Format, méthode (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 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 |
|---|---|
|
Le système de fichiers a été correctement mis en forme. |
|
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. |
|
Le volume a échoué. |
|
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 |
|---|---|
|
Le système de fichiers est mis en forme, mais pas compressé. |
|
Le système de fichiers n’est pas compatible. |
|
Le média n’est pas compatible. |
|
L’accès est refusé. |
|
Le média est protégé en écriture. |
|
L’étiquette n’est pas valide. |
|
Le volume ne peut pas être mis en forme rapidement. |
|
Une erreur d’E/S s’est produite pendant le format. |
|
La taille du volume est trop petite pour être mise en forme. |
|
La taille du volume est trop grande pour être mise en forme. |
|
La taille du cluster est trop petite pour permettre la mise en forme. |
|
La taille du cluster est trop grande pour permettre la mise en forme. |
|
Le nombre de clusters est trop grand pour être représenté sous la forme d’un entier 32 bits. |
|
La valeur du paramètre de type n’était pas VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 ou VDS_FST_UDF. |
|
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 |