GetTapeParameters-Funktion (winbase.h)

Artikel
03/03/2024

Die GetTapeParameters-Funktion ruft Informationen ab, die das Band oder das Bandlaufwerk beschreiben.

Syntax

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Parameter

[in] hDevice

Verarbeiten Sie das Gerät, über das Informationen gesucht werden. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

[in] dwOperation

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

Wert	Bedeutung
GET_TAPE_DRIVE_INFORMATION 1	Ruft Informationen zum Bandgerät ab.
GET_TAPE_MEDIA_INFORMATION 0	Ruft Informationen zum Band auf dem Bandgerät ab.

[out] lpdwSize

Zeiger auf eine Variable, die die Größe des durch den lpTapeInformation-Parameter angegebenen Puffers in Bytes empfängt. Wenn der Puffer zu klein ist, erhält dieser Parameter die erforderliche Größe.

[out] lpTapeInformation

Zeiger auf eine Struktur, die die angeforderten Informationen enthält. Wenn der dwOperation-ParameterGET_TAPE_MEDIA_INFORMATION ist, verweist lpTapeInformation auf eine TAPE_GET_MEDIA_PARAMETERS-Struktur .

Wenn dwOperationGET_TAPE_DRIVE_INFORMATION ist, verweist lpTapeInformation auf eine TAPE_GET_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.

Fehlercode	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.

Hinweise

Die Werte des Blockgrößenbereichs (Maximum und Minimum), die von der GetTapeParameters-Funktion zurückgegeben werden, die mit dem dwOperation-Parameter auf den GET_TAPE_DRIVE_INFORMATION Wert festgelegt wird, geben Systemgrenzwerte und keine Laufwerksgrenzwerte an. Es sind jedoch das Bandlaufwerk und die im Laufwerk vorhandenen Medien, die die tatsächlichen Grenzwerte für die Blockgröße bestimmen. Daher kann eine Anwendung möglicherweise nicht alle Blockgrößen festlegen, die in dem Bereich erwähnt werden, der durch Angabe von GET_TAPE_DRIVE_INFORMATION in dwOperation abgerufen wird.

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

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS

Share via