IVdsDiskPartitionMF::FormatPartitionEx-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Formatiert eine vorhandene OEM-, ESP- oder unbekannte Partition.

Syntax

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

Parameter

[in] ullOffset

Byteoffset der Partition vom Anfang des Datenträgers. Dieser Offset muss der Offset des Anfangs einer Partition sein.

[in] pwszFileSystemTypeName

Eine MIT NULL beendete Unicode-Zeichenfolge, die den Namen des Dateisystems enthält, mit dem die Partition formatiert werden soll. Muss NULL oder eine der folgenden Werte sein: "NTFS", "FAT", "FAT32", "UDF" oder "EXFAT". Wenn dieser Parameter NULL ist, wird ein Standardwert verwendet.

[in] usFileSystemRevision

Die Revision des Dateisystems, falls vorhanden. Dieses Element wird als 16-Bit-binärcodierte Dezimalzahl ausgedrückt, wobei zwischen der zweiten und dritten Ziffer ein Dezimalpunkt impliziert wird. Ein Wert von 0x0250 gibt beispielsweise die Version 2.50 an.

[in] ulDesiredUnitAllocationSize

Die Größe der Zuordnungseinheit für das Dateisystem in Bytes. Der Wert muss eine Leistung von 2 sein. Wenn der Wert 0 ist, wird eine Standardzuordnungseinheit verwendet, die vom Dateisystemtyp bestimmt wird. Der Bereich der Zuordnungseinheit ist dateisystemabhängig.

[in] pwszLabel

Unicode-Zeichenfolge mit Null-Endung, die dem neuen Dateisystem für das Volume zugewiesen werden soll. Die maximale Bezeichnungsgröße ist dateisystemabhängig.

[in] bForce

Boolesch, der bestimmt, ob ein Dateisystemformat erzwungen wird, unabhängig davon, ob die Partition verwendet wird.

[in] bQuickFormat

Boolesch, der bestimmt, ob ein Dateisystemvolume schnell formatiert ist. Ein Schnellformat überprüft nicht jeden Sektor auf dem Volume.

[in] bEnableCompression

Boolesch, der bestimmt, ob ein Dateisystem mit aktivierter Komprimierung erstellt wird.

[out] ppAsync

Zeiger auf eine IVdsAsync-Schnittstelle , die nach erfolgreichem Abschluss die IVdsAsync-Schnittstelle empfängt, um diesen Vorgang zu überwachen und zu steuern. Aufrufer müssen die empfangene Schnittstelle freigeben, wenn sie damit fertig sind.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Darüber hinaus kann die IVdsAsync-Schnittstelle die folgenden zugehörigen Warnungen und Fehlercodes zurückgeben.

Hinweise

Diese Methode formatiert nur OEM-, ESP- und unbekannte Partitionen. Für andere Partitionen müssen Sie stattdessen das entsprechende Volume mit der IVdsVolumeMF::Format - oder IVdsVolumeMF2::FormatEx-Methode formatieren. Beachten Sie, dass OEM-, ESP- und unbekannte Partitionen nicht als Volumes verfügbar gemacht werden und daher nicht mit Format oder FormatEx formatiert werden können.

Diese Methode kann nicht zum Formatieren von Wechselmedien verwendet werden.

Wenn eine OEM-Partition als FAT oder FAT32 formatiert ist, ändert sich der Partitionstyp nicht. Wenn er mit NTFS formatiert ist, ändert sich der Partitionstyp in PARTITION_IFS (0x07). Informationen zu Partitionstypen finden Sie unter CREATE_PARTITION_PARAMETERS.

Weitere Informationen zu Dateisystemgrenzwerten wie der minimalen und maximalen Größe der Zuordnungseinheiten (auch als Clustergröße bezeichnet) finden Sie unter Technische Referenz zu NTFS und FAT Technical Reference.

Anforderungen

Weitere Informationen

IVdsAdvancedDisk::FormatPartition

IVdsDiskPartitionMF