Méthode IVdsDiskPartitionMF ::FormatPartitionEx (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 FormatPartitionEx(
[in] ULONGLONG ullOffset,
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] BOOL bForce,
[in] BOOL bQuickFormat,
[in] BOOL bEnableCompression,
[out] IVdsAsync **ppAsync
);
Paramètres
[in] ullOffset
Décalage en octets de la partition à partir du début du disque. Ce décalage doit être le décalage du début d’une partition.
[in] pwszFileSystemTypeName
Chaîne Unicode terminée par null contenant le nom du système de fichiers avec lequel mettre en forme la partition. Doit être NULL ou l’une des valeurs suivantes : « NTFS », « FAT », « FAT32 », « UDF » ou « EXFAT ». Si ce paramètre a la valeur NULL, une valeur par défaut est utilisée.
[in] usFileSystemRevision
Révision du système de fichiers, le cas échéant. Ce membre est exprimé sous la forme d’un nombre décimal codé par binaire 16 bits, où une virgule décimale est impliquée entre le deuxième et le troisième chiffre. Par exemple, la valeur 0x0250 indique la révision 2.50.
[in] ulDesiredUnitAllocationSize
Taille de l’unité d’allocation pour le système de fichiers, en octets. La valeur doit être une puissance de 2. Si la valeur est 0, une unité d’allocation par défaut déterminée par le type de système de fichiers est utilisée. La plage d’unités d’allocation dépend du système de fichiers.
[in] pwszLabel
Chaîne Unicode terminée par null à affecter au nouveau système de fichiers pour le volume. La taille maximale des étiquettes dépend du système de fichiers.
[in] bForce
Boolean qui détermine si un format de système de fichiers est forcé, que la partition soit en cours d’utilisation ou non.
[in] bQuickFormat
Boolean qui détermine si un volume de système de fichiers est mis en forme rapidement. Un format rapide ne vérifie pas chaque secteur sur le volume.
[in] bEnableCompression
Boolean qui détermine si un système de fichiers sera créé avec la compression activée.
[out] ppAsync
Pointeur vers une interface IVdsAsync qui, une fois l’exécution réussie, reçoit l’interface IVdsAsync pour surveiller et contrôler cette opération. Les appelants doivent libérer l’interface reçue lorsqu’ils en ont terminé.
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 volume a été partitionné avec succès. |
|
Un fournisseur a retourné des données incorrectes. |
|
L’opération n’est pas prise en charge sur un support amovible. |
|
Impossible de déterminer le système de fichiers par défaut. |
|
Le disque est manquant. |
|
La partition n’existe pas. |
|
L’opération n’est pas prise en charge sur les partitions non OEM. |
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é. |
|
L’accès est refusé. |
|
L’étiquette n’est pas valide. |
|
Le volume ne peut pas être mis en forme rapidement. |
|
Le nombre de clusters est trop grand pour être représenté sous la forme d’un entier 32 bits. |
|
La taille du cluster est trop grande pour permettre la mise en forme. |
|
La taille du cluster est trop petite pour permettre la mise en forme. |
|
Le système de fichiers n’est pas compatible. |
|
Le média n’est pas compatible. |
|
Une erreur d’E/S s’est produite pendant le format. |
|
Le média est protégé en écriture. |
|
La taille du volume est trop grande pour être mise en forme. |
|
La taille du volume est trop petite pour être mise en forme. |
Remarques
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.
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.
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vds.h |
| Bibliothèque | Uuid.lib |