Funzione PrepareTape (winbase.h)

  • Articolo

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