Funzione CreateTapePartition (winbase.h)

Articolo
03/03/2024

La funzione CreateTapePartition riformatta un nastro.

Sintassi

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Parametri

[in] hDevice

Gestire il dispositivo in cui verrà creata la nuova partizione. Questo handle viene creato usando la funzione CreateFile .

[in] dwPartitionMethod

Tipo di partizione da creare. Per determinare il tipo di partizioni supportate dal dispositivo, vedere la documentazione per l'hardware. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TAPE_FIXED_PARTITIONS 0L	Partiziona il nastro in base alla definizione predefinita del dispositivo delle partizioni. I parametri dwCount e dwSize vengono ignorati.
TAPE_INITIATOR_PARTITIONS 2L	Partiziona rispettivamente il nastro nel numero e nella dimensione delle partizioni specificate da dwCount e dwSize, ad eccezione dell'ultima partizione. Le dimensioni dell'ultima partizione sono il resto del nastro.
TAPE_SELECT_PARTITIONS 1L	Partiziona il nastro nel numero di partizioni specificate da dwCount. Il parametro dwSize viene ignorato. Le dimensioni delle partizioni sono determinate dalle dimensioni predefinite della partizione del dispositivo. Per informazioni più specifiche, vedere la documentazione per il dispositivo nastro.

[in] dwCount

Numero di partizioni da creare. La funzione GetTapeParameters fornisce il numero massimo di partizioni che un nastro può supportare.

[in] dwSize

Dimensioni di ogni partizione, in megabyte. Questo valore viene ignorato se il parametro dwPartitionMethod è TAPE_SELECT_PARTITIONS.

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_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_SETMARK_DETECTED 1103L	Un segno di impostazione è stato raggiunto durante un'operazione.
ERROR_NO_DATA_DETECTED 1104L	Il marcatore end-of-data è stato raggiunto durante un'operazione.
ERROR_PARTITION_FAILURE 1105L	Impossibile partizionare il nastro.
ERROR_INVALID_BLOCK_LENGTH 1106L	Le dimensioni del blocco non sono corrette su un nuovo nastro in una partizione multivolume.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Impossibile trovare le informazioni sulla partizione quando è stato caricato un nastro.
ERROR_MEDIA_CHANGED 1110L	Il nastro che era nell'unità è stato sostituito o rimosso.
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_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

La creazione di partizioni riformatta il nastro. Tutte le informazioni precedenti registrate sul nastro vengono distrutte.

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

GetTapeParameters

Condividi tramite