struttura TAPE_GET_DRIVE_PARAMETERS (ntddtape.h)
La struttura TAPE_GET_DRIVE_PARAMETERS viene usata insieme alla richiesta di IOCTL_TAPE_GET_DRIVE_PARAMS per recuperare informazioni sulle funzionalità dell'unità nastro.
Sintassi
typedef struct _TAPE_GET_DRIVE_PARAMETERS {
BOOLEAN ECC;
BOOLEAN Compression;
BOOLEAN DataPadding;
BOOLEAN ReportSetmarks;
ULONG DefaultBlockSize;
ULONG MaximumBlockSize;
ULONG MinimumBlockSize;
ULONG MaximumPartitionCount;
ULONG FeaturesLow;
ULONG FeaturesHigh;
ULONG EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;
Members
ECC
Se impostato su TRUE, indica che il dispositivo usa la correzione degli errori hardware.
Compression
Se impostato su TRUE, indica che la compressione è abilitata in un dispositivo che lo supporta. Quando la compressione è abilitata, il dispositivo comprime i dati prima di scriverlo. Se impostata su FALSE, la compressione non è abilitata nel dispositivo.
DataPadding
Se impostato su TRUE, indica che la spaziatura interna dei dati è abilitata in un dispositivo che lo supporta. Quando la spaziatura interna è abilitata, il dispositivo riempie i dati con zeri per mantenere il flusso di nastri fino a quando i dati non sono pronti. Se impostato su FALSE, la spaziatura interna dei dati non è abilitata.
ReportSetmarks
Se impostato su TRUE, indica che i segni di segnalazione sono abilitati in un dispositivo che lo supporta. Il dispositivo segnala i segni di impostazione rilevati durante le operazioni di lettura o spazio. Se impostato su FALSE, la segnalazione dei segni di impostazione non è abilitata.
DefaultBlockSize
Indica le dimensioni predefinite del blocco, in byte.
MaximumBlockSize
Indica le dimensioni massime del blocco, in byte, del dispositivo nastro o dell'adattatore bus host sottostante( HBA), a qualsiasi valore inferiore.
MinimumBlockSize
Indica le dimensioni minime del blocco, in byte.
MaximumPartitionCount
Indica il numero massimo di partizioni supportate dal dispositivo.
FeaturesLow
Indica le funzionalità supportate da questa unità. Il driver miniport imposta i flag TAPE_DRIVE_XXX per le funzionalità supportate dall'unità e cancella i flag per le funzionalità non supportate. I chiamanti possono usare le maschere TAPE_DRIVE_XXX definite in minitape.h per determinare se un'unità supporta una particolare funzionalità. Le maschere disponibili sono le seguenti:
| Mask | Significato |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | Il dispositivo può segnalare se richiede la pulizia. |
| TAPE_DRIVE_COMPRESSION | Il dispositivo supporta la compressione dei dati hardware. |
| TAPE_DRIVE_ECC | Il dispositivo supporta la correzione degli errori hardware. |
| TAPE_DRIVE_EJECT_MEDIA | Il dispositivo rimuove il supporto. |
| TAPE_DRIVE_EOT_WZ_SIZE | Il dispositivo può segnalare la dimensione dell'avviso di fine zona. |
| TAPE_DRIVE_ERASE_BOP_ONLY | Il dispositivo esegue l'operazione di cancellazione solo dall'indicatore di partizione iniziale. |
| TAPE_DRIVE_ERASE_IMMEDIATE | Il dispositivo esegue un'operazione di cancellazione immediata ?? vale a dire, restituisce all'inizio dell'operazione di cancellazione. |
| TAPE_DRIVE_ERASE_LONG | Il dispositivo esegue un'operazione di cancellazione lunga. |
| TAPE_DRIVE_ERASE_SHORT | Il dispositivo esegue un'operazione di cancellazione breve. |
| TAPE_DRIVE_FIXED | Il dispositivo crea partizioni dati fisse. |
| TAPE_DRIVE_FIXED_BLOCK | Il dispositivo supporta la modalità blocco a lunghezza fissa. |
| TAPE_DRIVE_INITIATOR | Il dispositivo crea partizioni definite dall'iniziatore. |
| TAPE_DRIVE_GET_ABSOLUTE_BLK | Il dispositivo fornisce l'indirizzo di blocco specifico del dispositivo corrente. |
| TAPE_DRIVE_GET_LOGICAL_BLK | Il dispositivo fornisce l'indirizzo del blocco logico corrente (e la partizione nastro logica). |
| TAPE_DRIVE_PADDING | Il dispositivo supporta la spaziatura interna dei dati. |
| TAPE_DRIVE_REPORT_SMKS | Il dispositivo supporta la creazione di report setmark. |
| TAPE_DRIVE_RESERVED_BIT | Maschera che identifica un bit riservato. I driver non devono impostare questo bit. |
| TAPE_DRIVE_SELECT | Il dispositivo crea partizioni di dati selezionate. |
| TAPE_DRIVE_SET_CMP_BOP_ONLY | Il dispositivo consente l'abilitazione della compressione solo quando l'intestazione di lettura/scrittura si trova all'inizio della partizione. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | Il dispositivo supporta l'impostazione delle dimensioni di avviso di fine media. |
| TAPE_DRIVE_TAPE_CAPACITY | Il dispositivo restituisce la capacità massima del nastro. |
| TAPE_DRIVE_TAPE_REMAINING | Il dispositivo restituisce la capacità rimanente del nastro. |
| TAPE_DRIVE_VARIABLE_BLOCK | Il dispositivo supporta la modalità blocco a lunghezza variabile. |
| TAPE_DRIVE_WRITE_PROTECT | Il dispositivo restituisce un errore se il nastro è abilitato per la scrittura o protetto da scrittura. |
FeaturesHigh
Indica le funzionalità aggiuntive supportate da questa unità se TAPE_DRIVE_HIGH_FEATURES è impostato in FeaturesLow. Il driver miniport imposta i flag TAPE_DRIVE_XXX per le funzionalità supportate dall'unità e cancella i flag per le funzionalità non supportate. I chiamanti possono usare le maschere TAPE_DRIVE_XXX definite in minitape.h per determinare se un'unità supporta una particolare funzionalità.
| Mask | Significato |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | Il dispositivo sposta il nastro su un indirizzo di blocco specifico del dispositivo e restituisce non appena inizia lo spostamento. |
| TAPE_DRIVE_ABSOLUTE_BLK | Il dispositivo sposta il nastro in un indirizzo di blocco specifico del dispositivo. |
| TAPE_DRIVE_END_OF_DATA | Il dispositivo sposta il nastro sull'indicatore di fine dati in una partizione. |
| TAPE_DRIVE_FILEMARKS | Il dispositivo sposta il nastro avanti (o indietro) un numero specificato di segni di file. |
| TAPE_DRIVE_FORMAT | Il dispositivo può formattare il supporto. |
| TAPE_DRIVE_FORMAT_IMMEDIATE | Il dispositivo può formattare il supporto come comando immediato. |
| TAPE_DRIVE_HIGH_FEATURES | Maschera di bit che indica i bit che corrispondono a funzionalità elevate. |
| TAPE_DRIVE_LOAD_UNLOAD | Il dispositivo abilita e disabilita il dispositivo per ulteriori operazioni. |
| TAPE_DRIVE_LOAD_UNLD_IMMED | Il dispositivo supporta operazioni immediate di caricamento e scaricamento. |
| TAPE_DRIVE_LOCK_UNLOCK | Il dispositivo abilita e disabilita il meccanismo di espulsione del nastro. |
| TAPE_DRIVE_LOCK_UNLK_IMMED | Il dispositivo supporta operazioni immediate di blocco e sblocco. |
| TAPE_DRIVE_LOG_BLK_IMMED | 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 | Il dispositivo sposta il nastro in un indirizzo di blocco logico in una partizione. |
| TAPE_DRIVE_RELATIVE_BLKS | Il dispositivo sposta il nastro avanti (o indietro) un numero specificato di blocchi. |
| TAPE_DRIVE_REVERSE_POSITION | Il dispositivo sposta il nastro all'indietro su blocchi, segni di file o segni di impostazione. |
| TAPE_DRIVE_REWIND_IMMEDIATE | Il dispositivo supporta un'operazione di riavvolgimento immediato. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | Il dispositivo sposta il nastro avanti (o indietro) alla prima occorrenza di un numero specificato di contrassegni di file consecutivi. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | Il dispositivo sposta il nastro avanti (o indietro) alla prima occorrenza di un numero specificato di segni di impostazione consecutivi. |
| TAPE_DRIVE_SET_BLOCK_SIZE | 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 | Il dispositivo abilita e disabilita la compressione dei dati hardware. |
| TAPE_DRIVE_SET_ECC | Il dispositivo abilita e disabilita la correzione degli errori hardware. |
| TAPE_DRIVE_SET_PADDING | Il dispositivo abilita e disabilita la spaziatura interna dei dati. |
| TAPE_DRIVE_SET_REPORT_SMKS | Il dispositivo abilita e disabilita la segnalazione dei segni di impostazione. |
| TAPE_DRIVE_SETMARKS | Il dispositivo sposta il nastro in avanti (o inverso) un numero specificato di segni di impostazione. |
| TAPE_DRIVE_SPACE_IMMEDIATE | Il dispositivo supporta la spaziatura immediata. |
| TAPE_DRIVE_TENSION | Il dispositivo supporta la tensione del nastro. |
| TAPE_DRIVE_TENSION_IMMED | Il dispositivo supporta la tensione immediata del nastro. |
| TAPE_DRIVE_WRITE_FILEMARKS | Il dispositivo scrive i segni di file. |
| TAPE_DRIVE_WRITE_LONG_FMKS | Il dispositivo scrive i segni di file lunghi. |
| TAPE_DRIVE_WRITE_MARK_IMMED | Il dispositivo supporta la scrittura immediata di segni di file brevi e lunghi. |
| TAPE_DRIVE_WRITE_SETMARKS | Il dispositivo scrive i segni di impostazione. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | Il dispositivo scrive i segni di file brevi. |
EOTWarningZoneSize
Indica le dimensioni in byte della zona di avviso anticipato verso la fine del nastro. Il dispositivo restituisce una condizione di controllo quando entra nella zona.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddtape.h (include Ntddtape.h, Minitape.h) |