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)

Vedi anche

IOCTL_TAPE_GET_DRIVE_PARAMS

TapeMiniGetDriveParameters