CreateTapePartition-Funktion (winbase.h)

Artikel
08/27/2023

Die CreateTapePartition-Funktion erstellt ein Band neu.

Syntax

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Parameter

[in] hDevice

Handle an das Gerät, auf dem die neue Partition erstellt werden soll. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

[in] dwPartitionMethod

Typ der zu erstellenden Partition. Informationen dazu, welche Art von Partitionen Ihr Gerät unterstützt, finden Sie in der Dokumentation für Ihre Hardware. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
TAPE_FIXED_PARTITIONS 0L	Partitioniert das Band basierend auf der Standarddefinition von Partitionen des Geräts. Die Parameter dwCount und dwSize werden ignoriert.
TAPE_INITIATOR_PARTITIONS 2L	Partitioniert das Band in die Anzahl und Größe der Partitionen, die von dwCount bzw . dwSize angegeben sind, mit Ausnahme der letzten Partition. Die Größe der letzten Partition ist der Rest des Bandes.
TAPE_SELECT_PARTITIONS 1 L	Partitioniert das Band in die Anzahl von Partitionen, die von dwCount angegeben werden. Der dwSize-Parameter wird ignoriert. Die Größe der Partitionen wird durch die Standardpartitionsgröße des Geräts bestimmt. Ausführlichere Informationen finden Sie in der Dokumentation für Ihr Bandgerät.

[in] dwCount

Anzahl der zu erstellenden Partitionen. Die GetTapeParameters-Funktion stellt die maximale Anzahl von Partitionen bereit, die ein Band unterstützen kann.

[in] dwSize

Größe jeder Partition in Megabyte. Dieser Wert wird ignoriert, wenn der dwPartitionMethod-ParameterTAPE_SELECT_PARTITIONS ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, kann sie einen der folgenden Fehlercodes zurückgeben.

Fehler	BESCHREIBUNG
ERROR_BEGINNING_OF_MEDIA 1102L	Ein Versuch, vor dem Anfang des mittleren Markers auf Daten zuzugreifen, ist fehlgeschlagen.
ERROR_BUS_RESET 1111L	Im Bus wurde eine Zurücksetzungsbedingung erkannt.
ERROR_END_OF_MEDIA 1100L	Der Bandendemarker wurde während eines Vorgangs erreicht.
ERROR_FILEMARK_DETECTED 1101L	Während eines Vorgangs wurde ein Filemark erreicht.
ERROR_SETMARK_DETECTED 1103L	Während eines Vorgangs wurde ein Setmark erreicht.
ERROR_NO_DATA_DETECTED 1104L	Der Datenendemarker wurde während eines Vorgangs erreicht.
ERROR_PARTITION_FAILURE 1105L	Das Band konnte nicht partitioniert werden.
ERROR_INVALID_BLOCK_LENGTH 1106L	Die Blockgröße ist auf einem neuen Band in einer mehrvolumen Partition falsch.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Die Partitionsinformationen konnten nicht gefunden werden, wenn ein Band geladen wurde.
ERROR_MEDIA_CHANGED 1110L	Das Band, das sich auf dem Laufwerk befand, wurde ersetzt oder entfernt.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Das Laufwerk enthält keine Medien.
ERROR_NOT_SUPPORTED 50L	Der Bandtreiber unterstützt keine angeforderte Funktion.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Fehler beim Versuch, den Auswurfmechanismus zu sperren.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Fehler beim Entladen des Bandes.
ERROR_WRITE_PROTECT 19L	Das Medium ist schreibgeschützt.

Hinweise

Beim Erstellen von Partitionen wird das Band neu erstellt. Alle zuvor auf dem Band aufgezeichneten Informationen werden zerstört.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CreateFile

GetTapeParameters

Share via