SetTapeParameters-Funktion (winbase.h)

Artikel
08/27/2023

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

Share via