Funzione GetTapeStatus (winbase.h)

La funzione GetTapeStatus determina se il dispositivo nastro è pronto per elaborare i comandi nastro.

Sintassi

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

Parametri

[in] hDevice

Gestire il dispositivo per il quale ottenere lo stato del dispositivo. Questo handle viene creato usando la funzione CreateFile .

Valore restituito

Se il dispositivo nastro è pronto per accettare comandi di accesso a nastro appropriati senza restituire errori, il valore restituito è NO_ERROR.

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

Codice di 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_DEVICE_REQUIRES_CLEANING
1165L
L'unità nastro è in grado di segnalare che richiede la pulizia e segnala che richiede la pulizia.
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

Requisito Valore
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