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 |
|---|---|
|
La partition a été mise en forme avec succès. |
|
Le disque est amovible ou la partition n’est pas de type OEM, ESP ou inconnu. |
|
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 |