Funzione SetTapeParameters (winbase.h)

Articolo
08/27/2023

La funzione SetTapeParameters specifica le dimensioni del blocco di un nastro o configura il dispositivo nastro.

Sintassi

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

Parametri

[in] hDevice

Gestire il dispositivo per il quale impostare le informazioni di configurazione. Questo handle viene creato usando la funzione CreateFile .

[in] dwOperation

Tipo di informazioni da impostare. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
SET_TAPE_DRIVE_INFORMATION 1L	Imposta le informazioni specifiche del dispositivo specificate da lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION 0L	Imposta le informazioni specifiche del nastro specificate dal parametro lpTapeInformation .

[in] lpTapeInformation

Puntatore a una struttura che contiene le informazioni da impostare. Se il parametro dwOperation è SET_TAPE_MEDIA_INFORMATION, lpTapeInformation punta a una struttura TAPE_SET_MEDIA_PARAMETERS .

Se dwOperation è SET_TAPE_DRIVE_INFORMATION, lpTapeInformation punta a una struttura TAPE_SET_DRIVE_PARAMETERS .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, può restituire uno dei codici di errore seguenti.

Errore	Descrizione
ERROR_BEGINNING_OF_MEDIA 1102L	Tentativo di accesso ai dati prima dell'inizio del marcatore medio non riuscito.
ERROR_BUS_RESET 1111L	È stata rilevata una condizione di reimpostazione sul bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Impossibile trovare le informazioni sulla partizione durante il caricamento di un nastro.
ERROR_END_OF_MEDIA 1100L	L'indicatore di fine nastro è stato raggiunto durante un'operazione.
ERROR_FILEMARK_DETECTED 1101L	È stato raggiunto un segno di file durante un'operazione.
ERROR_INVALID_BLOCK_LENGTH 1106L	La dimensione del blocco non è corretta in un nuovo nastro in una partizione multivolume.
ERROR_MEDIA_CHANGED 1110L	Il nastro presente nell'unità è stato sostituito o rimosso.
ERROR_NO_DATA_DETECTED 1104L	Il marcatore di fine dati è stato raggiunto durante un'operazione.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Non è presente alcun supporto nell'unità.
ERROR_NOT_SUPPORTED 50L	Il driver di nastro non supporta una funzione richiesta.
ERROR_PARTITION_FAILURE 1105L	Impossibile partizionare il nastro.
ERROR_SETMARK_DETECTED 1103L	È stato raggiunto un segno di impostazione durante un'operazione.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Tentativo di blocco del meccanismo di espulsione non riuscito.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Tentativo di scaricamento del nastro non riuscito.
ERROR_WRITE_PROTECT 19L	Il supporto è protetto da scrittura.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS

Condividi tramite