SetTapeParameters-Funktion (winbase.h)

Die SetTapeParameters-Funktion gibt entweder die Blockgröße eines Bandes an oder konfiguriert das Bandgerät.

Syntax

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

Parameter

[in] hDevice

Handle an das Gerät, für das Konfigurationsinformationen festgelegt werden sollen. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

[in] dwOperation

Typ der festzulegenden Informationen. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert Bedeutung
SET_TAPE_DRIVE_INFORMATION
1 L
Legt die gerätespezifischen Informationen fest, die von lpTapeInformation angegeben werden.
SET_TAPE_MEDIA_INFORMATION
0L
Legt die bandspezifischen Informationen fest, die durch den lpTapeInformation-Parameter angegeben werden.

[in] lpTapeInformation

Zeiger auf eine Struktur, die die festzulegenden Informationen enthält. Wenn der dwOperation-Parameter SET_TAPE_MEDIA_INFORMATION ist, verweist lpTapeInformation auf eine TAPE_SET_MEDIA_PARAMETERS-Struktur .

Wenn dwOperation SET_TAPE_DRIVE_INFORMATION ist, verweist lpTapeInformation auf eine TAPE_SET_DRIVE_PARAMETERS-Struktur .

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_DEVICE_NOT_PARTITIONED
1107L
Die Partitionsinformationen konnten nicht gefunden werden, wenn ein Band geladen wurde.
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_INVALID_BLOCK_LENGTH
1106L
Die Blockgröße ist auf einem neuen Band in einer mehrvolumen Partition falsch.
ERROR_MEDIA_CHANGED
1110L
Das Band, das sich auf dem Laufwerk befand, wurde ersetzt oder entfernt.
ERROR_NO_DATA_DETECTED
1104L
Der Datenendemarker wurde während eines Vorgangs erreicht.
ERROR_NO_MEDIA_IN_DRIVE
1112L
Das Laufwerk enthält keine Medien.
ERROR_NOT_SUPPORTED
50L
Der Bandtreiber unterstützt keine angeforderte Funktion.
ERROR_PARTITION_FAILURE
1105L
Das Band konnte nicht partitioniert werden.
ERROR_SETMARK_DETECTED
1103L
Während eines Vorgangs wurde ein Setmark erreicht.
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.

Anforderungen

   
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

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS