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.
[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 |
---|---|
|
Ein Versuch, vor dem Anfang des mittleren Markers auf Daten zuzugreifen, ist fehlgeschlagen. |
|
Im Bus wurde eine Zurücksetzungsbedingung erkannt. |
|
Die Partitionsinformationen konnten nicht gefunden werden, wenn ein Band geladen wurde. |
|
Der Bandendemarker wurde während eines Vorgangs erreicht. |
|
Während eines Vorgangs wurde ein Filemark erreicht. |
|
Die Blockgröße ist auf einem neuen Band in einer mehrvolumen Partition falsch. |
|
Das Band, das sich auf dem Laufwerk befand, wurde ersetzt oder entfernt. |
|
Der Datenendemarker wurde während eines Vorgangs erreicht. |
|
Das Laufwerk enthält keine Medien. |
|
Der Bandtreiber unterstützt keine angeforderte Funktion. |
|
Das Band konnte nicht partitioniert werden. |
|
Während eines Vorgangs wurde ein Setmark erreicht. |
|
Fehler beim Versuch, den Auswurfmechanismus zu sperren. |
|
Fehler beim Entladen des Bandes. |
|
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 |