Funzione WriteTapemark (winbase.h)

Articolo
03/03/2024

La funzione WriteTapemark scrive un numero specificato di segni di file, contrassegni set, segni di file brevi o segni di file lunghi in un dispositivo nastro. Questi segni di nastro dividono una partizione di nastro in aree più piccole.

Sintassi

DWORD WriteTapemark(
  [in] HANDLE hDevice,
  [in] DWORD  dwTapemarkType,
  [in] DWORD  dwTapemarkCount,
  [in] BOOL   bImmediate
);

Parametri

[in] hDevice

Gestire il dispositivo su cui scrivere i segni di nastro. Questo handle viene creato usando la funzione CreateFile .

[in] dwTapemarkType

Tipo di segni di nastro da scrivere. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TAPE_FILEMARKS 1L	Scrive il numero di segni di file specificati dal parametro dwTapemarkCount .
TAPE_LONG_FILEMARKS 3L	Scrive il numero di segni di file lunghi specificati da dwTapemarkCount.
TAPE_SETMARKS 0L	Scrive il numero di setmark specificati da dwTapemarkCount.
TAPE_SHORT_FILEMARKS 2L	Scrive il numero di segni di file brevi specificati da dwTapemarkCount.

[in] dwTapemarkCount

Numero di segni di nastro da scrivere.

[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

I segni di file, i contrassegni set, i segni di file brevi e i segni di file lunghi sono elementi registrati speciali che indicano l'organizzazione lineare del nastro. Nessuno di questi segni contiene dati utente. I segni di file sono i segni più generali; setmarks forniscono una gerarchia non disponibile con i segni di file.

Un breve segno di file contiene un breve gap di cancellazione che non può essere sovrascritto a meno che l'operazione di scrittura non venga eseguita dall'inizio della partizione o da un filemark lungo precedente.

Un filemark lungo contiene un intervallo di cancellazione lungo che consente a un'applicazione di posizionare il nastro all'inizio del segno di file e di sovrascrivere il segno di file e il divario di cancellazione.

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

Condividi tramite