struttura TAPE_GET_DRIVE_PARAMETERS (winnt.h)

Articolo
03/08/2023

La struttura TAPE_GET_DRIVE_PARAMETERS descrive l'unità nastro. Viene usato dalla funzione GetTapeParameters .

Sintassi

typedef struct _TAPE_GET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  DWORD   DefaultBlockSize;
  DWORD   MaximumBlockSize;
  DWORD   MinimumBlockSize;
  DWORD   MaximumPartitionCount;
  DWORD   FeaturesLow;
  DWORD   FeaturesHigh;
  DWORD   EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;

Members

ECC

Se questo membro è TRUE, il dispositivo supporta la correzione degli errori hardware. In caso contrario, questo non accade.

Compression

Se questo membro è TRUE, la compressione dei dati hardware è abilitata. In caso contrario, è disabilitato.

DataPadding

Se questo membro è TRUE, la spaziatura interna dei dati è abilitata. In caso contrario, è disabilitato. La spaziatura interna dei dati mantiene il flusso di nastri a una velocità costante.

ReportSetmarks

Se questo membro è TRUE, la segnalazione dei segni di impostazione è abilitata. In caso contrario, è disabilitato.

DefaultBlockSize

Dimensioni predefinite del blocco fisso del dispositivo, in byte.

MaximumBlockSize

Dimensioni massime del blocco del dispositivo, in byte.

MinimumBlockSize

Dimensioni minime del blocco del dispositivo, in byte.

MaximumPartitionCount

Numero massimo di partizioni che è possibile creare nel dispositivo.

FeaturesLow

Bit in ordine basso del flag delle funzionalità del dispositivo. Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
TAPE_DRIVE_COMPRESSION 0x00020000	Il dispositivo supporta la compressione dei dati hardware.
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	Il dispositivo può segnalare se è necessaria la pulizia.
TAPE_DRIVE_ECC 0x00010000	Il dispositivo supporta la correzione degli errori hardware.
TAPE_DRIVE_EJECT_MEDIA 0x01000000	Il dispositivo espelle fisicamente il nastro su un software espulso.
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	Il dispositivo esegue l'operazione di cancellazione solo dall'indicatore di partizione iniziale.
TAPE_DRIVE_ERASE_LONG 0x00000020	Il dispositivo esegue un'operazione di cancellazione lunga.
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	Il dispositivo esegue un'operazione di cancellazione immediata, ovvero quando inizia l'operazione di cancellazione.
TAPE_DRIVE_ERASE_SHORT 0x00000010	Il dispositivo esegue un'operazione di cancellazione breve.
TAPE_DRIVE_FIXED 0x00000001	Il dispositivo crea partizioni dati fisse.
TAPE_DRIVE_FIXED_BLOCK 0x00000400	Il dispositivo supporta la modalità blocco a lunghezza fissa.
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	Il dispositivo fornisce l'indirizzo di blocco specifico del dispositivo corrente.
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	Il dispositivo fornisce l'indirizzo del blocco logico corrente (e la partizione nastro logica).
TAPE_DRIVE_INITIATOR 0x00000004	Il dispositivo crea partizioni definite dall'iniziatore.
TAPE_DRIVE_PADDING 0x00040000	Il dispositivo supporta la spaziatura interna dei dati.
TAPE_DRIVE_REPORT_SMKS 0x00080000	Il dispositivo supporta la creazione di report setmark.
TAPE_DRIVE_SELECT 0x00000002	Il dispositivo crea partizioni di dati selezionate.
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	Il dispositivo deve trovarsi all'inizio di una partizione prima di poter impostare la compressione.
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	Il dispositivo supporta l'impostazione delle dimensioni di avviso di fine media.
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	Il dispositivo restituisce la capacità massima del nastro.
TAPE_DRIVE_TAPE_REMAINING 0x00000200	Il dispositivo restituisce la capacità rimanente del nastro.
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	Il dispositivo supporta la modalità blocco a lunghezza variabile.
TAPE_DRIVE_WRITE_PROTECT 0x00001000	Il dispositivo restituisce un errore se il nastro è abilitato per la scrittura o protetto da scrittura.

FeaturesHigh

Bit di ordine elevato del flag delle funzionalità del dispositivo. Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	Il dispositivo sposta il nastro su un indirizzo di blocco specifico del dispositivo e restituisce non appena inizia lo spostamento.
TAPE_DRIVE_ABSOLUTE_BLK 0x80001000	Il dispositivo sposta il nastro in un indirizzo di blocco specifico del dispositivo.
TAPE_DRIVE_END_OF_DATA 0x80010000	Il dispositivo sposta il nastro sul marcatore end-of-data in una partizione.
TAPE_DRIVE_FILEMARKS 0x80040000	Il dispositivo sposta il nastro avanti (o indietro) un numero specificato di segni di file.
TAPE_DRIVE_LOAD_UNLOAD 0x80000001	Il dispositivo abilita e disabilita il dispositivo per ulteriori operazioni.
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	Il dispositivo supporta operazioni di caricamento e scaricamento immediato.
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	Il dispositivo abilita e disabilita il meccanismo di esezione nastro.
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	Il dispositivo supporta operazioni di blocco e sblocco immediate.
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	Il dispositivo sposta il nastro in un indirizzo di blocco logico in una partizione e restituisce non appena inizia lo spostamento.
TAPE_DRIVE_LOGICAL_BLK 0x80004000	Il dispositivo sposta il nastro in un indirizzo di blocco logico in una partizione.
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	Il dispositivo sposta il nastro avanti (o indietro) un numero specificato di blocchi.
TAPE_DRIVE_REVERSE_POSITION 0x80400000	Il dispositivo sposta il nastro indietro su blocchi, segni di file o segni di set.
TAPE_DRIVE_REWIND_IMMEDIATE 0x80000008	Il dispositivo supporta un'operazione di riavvolgimento immediato.
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	Il dispositivo sposta il nastro avanti (o indietro) alla prima occorrenza di un numero specificato di contrassegni consecutivi.
TAPE_DRIVE_SEQUENTIAL_SMKS 0x80200000	Il dispositivo sposta il nastro avanti (o indietro) alla prima occorrenza di un numero specificato di setmark consecutivi.
TAPE_DRIVE_SET_BLOCK_SIZE 0x80000010	Il dispositivo supporta l'impostazione delle dimensioni di un blocco logico a lunghezza fissa o l'impostazione della modalità blocco a lunghezza variabile.
TAPE_DRIVE_SET_COMPRESSION 0x80000200	Il dispositivo abilita e disabilita la compressione dei dati hardware.
TAPE_DRIVE_SET_ECC 0x80000100	Il dispositivo abilita e disabilita la correzione degli errori hardware.
TAPE_DRIVE_SET_PADDING 0x80000400	Il dispositivo abilita e disabilita il riempimento dei dati.
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	Il dispositivo abilita e disabilita la creazione di report di setmark.
TAPE_DRIVE_SETMARKS 0x80100000	Il dispositivo sposta il nastro avanti (o inverso) un numero specificato di segni di set.
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	Il dispositivo supporta la spaziatura immediata.
TAPE_DRIVE_TENSION 0x80000002	Il dispositivo supporta la tensione nastro.
TAPE_DRIVE_TENSION_IMMED 0x80000040	Il dispositivo supporta la tensione immediata del nastro.
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	Il dispositivo scrive i segni di file.
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	Il dispositivo scrive i segni di file lunghi.
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	Il dispositivo supporta la scrittura immediata di segni di file brevi e lunghi.
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	Il dispositivo scrive i segni di set.
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	Il dispositivo scrive i segni di file brevi.

EOTWarningZoneSize

Indica il numero di byte tra l'avviso end-of-tape e la fine fisica del nastro.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winnt.h (includere Windows.h)

Vedi anche

GetTapeParameters

Condividi tramite