Funzione PrepareTape (winbase.h)

Articolo
08/27/2023

La funzione PrepareTape prepara il nastro a cui accedere o rimuovere.

Sintassi

DWORD PrepareTape(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] BOOL   bImmediate
);

Parametri

[in] hDevice

Handle per il dispositivo che prepara il nastro. Questo handle viene creato usando la funzione CreateFile .

[in] dwOperation

Preparazione del dispositivo nastro. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TAPE_FORMAT 5L	Esegue un formato di basso livello del nastro. Attualmente, solo il dispositivo QIC117 supporta questa funzionalità.
TAPE_LOAD 0L	Carica il nastro e sposta il nastro all'inizio.
TAPE_LOCK 3L	Blocca il meccanismo di espulsione del nastro in modo che il nastro non venga inserito accidentalmente.
TAPE_TENSION 2L	Regola la tensione spostando il nastro alla fine del nastro e torna all'inizio. Questa opzione non è supportata da tutti i dispositivi. Questo valore viene ignorato se non è supportato.
TAPE_UNLOAD 1L	Sposta il nastro all'inizio per la rimozione dal dispositivo. Dopo un'operazione di scaricamento riuscita, il dispositivo restituisce errori alle applicazioni che tentano di accedere al nastro fino a quando il nastro non viene caricato di nuovo.
TAPE_UNLOCK 4L	Sblocca il meccanismo di espulsione del nastro.

[in] bImmediate

Se questo parametro è TRUE, la funzione restituisce immediatamente. Se è FALSE, la funzione non restituisce fino al completamento dell'operazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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 quando è stato caricato un nastro.
ERROR_END_OF_MEDIA 1100L	Il marcatore finale del nastro è stato raggiunto durante un'operazione.
ERROR_FILEMARK_DETECTED 1101L	Un segno di file è stato raggiunto durante un'operazione.
ERROR_INVALID_BLOCK_LENGTH 1106L	Le dimensioni del blocco non sono corrette su un nuovo nastro in una partizione multivolume.
ERROR_MEDIA_CHANGED 1110L	Il nastro che era nell'unità è stato sostituito o rimosso.
ERROR_NO_DATA_DETECTED 1104L	Il marcatore end-of-data è stato raggiunto durante un'operazione.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Non sono presenti supporti 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	Un segno di impostazione è stato raggiunto durante un'operazione.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Tentativo di bloccare il meccanismo di espulsione non riuscito.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Tentativo di scaricare il nastro non riuscito.
ERROR_WRITE_PROTECT 19L	Il supporto è protetto da scrittura.

Commenti

Alcuni dispositivi nastro non supportano determinate operazioni su nastro. Per determinare le funzionalità del dispositivo nastro, vedere la documentazione del dispositivo nastro e usare la funzione GetTapeParameters .

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

CreateFile

GetTapeParameters

Condividi tramite