TAPE_GET_DRIVE_PARAMETERS estrutura (ntddtape.h)
A estrutura TAPE_GET_DRIVE_PARAMETERS é usada em conjunto com a solicitação IOCTL_TAPE_GET_DRIVE_PARAMS para recuperar informações sobre os recursos da unidade de fita.
Sintaxe
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;
Membros
ECC
Quando definido como TRUE, indica que o dispositivo usa a correção de erro de hardware.
Compression
Quando definido como TRUE, indica que a compactação está habilitada em um dispositivo que dá suporte a ele. Quando a compactação está habilitada, o dispositivo compacta os dados antes de escrevê-los. Quando definido como FALSE, a compactação não está habilitada no dispositivo.
DataPadding
Quando definido como TRUE, indica que o preenchimento de dados está habilitado em um dispositivo que dá suporte a ele. Quando o preenchimento está habilitado, o dispositivo preenche dados com zeros para manter o streaming de fita até que os dados estejam prontos. Quando definido como FALSE, o preenchimento de dados não está habilitado.
ReportSetmarks
Quando definido como TRUE, indica que os setmarks de relatório estão habilitados em um dispositivo que dá suporte a ele. O dispositivo relata as marcas de configuração encontradas durante operações de leitura ou espaço. Quando definido como FALSE, as marcas de configuração de relatório não estão habilitadas.
DefaultBlockSize
Indica o tamanho do bloco padrão, em bytes.
MaximumBlockSize
Indica o tamanho máximo do bloco, em bytes, do dispositivo de fita ou do HBA (adaptador de barramento de host) subjacente, o que for menor.
MinimumBlockSize
Indica o tamanho mínimo do bloco, em bytes.
MaximumPartitionCount
Indica o número máximo de partições compatíveis com o dispositivo.
FeaturesLow
Indica os recursos compatíveis com essa unidade. O driver de miniporto define sinalizadores TAPE_DRIVE_XXX para recursos compatíveis com a unidade e limpa sinalizadores para recursos sem suporte. Os chamadores podem usar as máscaras TAPE_DRIVE_XXX definidas em minitape.h para determinar se uma unidade dá suporte a um recurso específico. As máscaras disponíveis são as seguintes:
| Mask | Significado |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | O dispositivo pode relatar se ele requer limpeza. |
| TAPE_DRIVE_COMPRESSION | O dispositivo dá suporte à compactação de dados de hardware. |
| TAPE_DRIVE_ECC | O dispositivo dá suporte à correção de erro de hardware. |
| TAPE_DRIVE_EJECT_MEDIA | O dispositivo ejeta a mídia. |
| TAPE_DRIVE_EOT_WZ_SIZE | O dispositivo pode relatar o tamanho do aviso de fim da zona. |
| TAPE_DRIVE_ERASE_BOP_ONLY | O dispositivo executa a operação de apagamento somente do marcador de início da partição. |
| TAPE_DRIVE_ERASE_IMMEDIATE | O dispositivo executa uma operação de apagamento imediata ?? ou seja, retorna quando a operação de apagamento começa. |
| TAPE_DRIVE_ERASE_LONG | O dispositivo executa uma operação de apagamento longa. |
| TAPE_DRIVE_ERASE_SHORT | O dispositivo executa uma operação de apagamento curto. |
| TAPE_DRIVE_FIXED | O dispositivo cria partições de dados fixas. |
| TAPE_DRIVE_FIXED_BLOCK | O dispositivo dá suporte ao modo de bloco de comprimento fixo. |
| TAPE_DRIVE_INITIATOR | O dispositivo cria partições definidas pelo iniciador. |
| TAPE_DRIVE_GET_ABSOLUTE_BLK | O dispositivo fornece o endereço de bloco específico do dispositivo atual. |
| TAPE_DRIVE_GET_LOGICAL_BLK | O dispositivo fornece o endereço de bloco lógico atual (e a partição de fita lógica). |
| TAPE_DRIVE_PADDING | O dispositivo dá suporte ao preenchimento de dados. |
| TAPE_DRIVE_REPORT_SMKS | O dispositivo dá suporte ao relatório de setmark. |
| TAPE_DRIVE_RESERVED_BIT | Uma máscara que identifica um bit reservado. Os drivers não devem definir esse bit. |
| TAPE_DRIVE_SELECT | O dispositivo cria partições de dados selecionadas. |
| TAPE_DRIVE_SET_CMP_BOP_ONLY | O dispositivo só permite que a compactação seja habilitada quando o cabeçalho de leitura/gravação estiver no início da partição. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | O dispositivo dá suporte à definição do tamanho de aviso de fim de médio. |
| TAPE_DRIVE_TAPE_CAPACITY | O dispositivo retorna a capacidade máxima da fita. |
| TAPE_DRIVE_TAPE_REMAINING | O dispositivo retorna a capacidade restante da fita. |
| TAPE_DRIVE_VARIABLE_BLOCK | O dispositivo dá suporte ao modo de bloco de comprimento variável. |
| TAPE_DRIVE_WRITE_PROTECT | O dispositivo retornará um erro se a fita estiver habilitada para gravação ou protegida por gravação. |
FeaturesHigh
Indica os recursos adicionais compatíveis com essa unidade se TAPE_DRIVE_HIGH_FEATURES estiver definido em RecursosLow. O driver de miniporto define sinalizadores TAPE_DRIVE_XXX para recursos compatíveis com a unidade e limpa sinalizadores para recursos sem suporte. Os chamadores podem usar as máscaras TAPE_DRIVE_XXX definidas em minitape.h para determinar se uma unidade dá suporte a um recurso específico.
| Mask | Significado |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | O dispositivo move a fita para um endereço de bloco específico do dispositivo e retorna assim que a movimentação começa. |
| TAPE_DRIVE_ABSOLUTE_BLK | O dispositivo move a fita para um endereço de bloco específico do dispositivo. |
| TAPE_DRIVE_END_OF_DATA | O dispositivo move a fita para o marcador de fim de dados em uma partição. |
| TAPE_DRIVE_FILEMARKS | O dispositivo move a fita para frente (ou para trás) um número especificado de marcas de arquivo. |
| TAPE_DRIVE_FORMAT | O dispositivo pode formatar a mídia. |
| TAPE_DRIVE_FORMAT_IMMEDIATE | O dispositivo pode formatar a mídia como um comando imediato. |
| TAPE_DRIVE_HIGH_FEATURES | Uma máscara de bits que indica os bits que correspondem a recursos altos. |
| TAPE_DRIVE_LOAD_UNLOAD | O dispositivo habilita e desabilita o dispositivo para operações adicionais. |
| TAPE_DRIVE_LOAD_UNLD_IMMED | O dispositivo dá suporte a operações imediatas de carregamento e descarregamento. |
| TAPE_DRIVE_LOCK_UNLOCK | O dispositivo habilita e desabilita o mecanismo de ejeção de fita. |
| TAPE_DRIVE_LOCK_UNLK_IMMED | O dispositivo dá suporte a operações imediatas de bloqueio e desbloqueio. |
| TAPE_DRIVE_LOG_BLK_IMMED | O dispositivo move a fita para um endereço de bloco lógico em uma partição e retorna assim que a movimentação começa. |
| TAPE_DRIVE_LOGICAL_BLK | O dispositivo move a fita para um endereço de bloco lógico em uma partição. |
| TAPE_DRIVE_RELATIVE_BLKS | O dispositivo move a fita para frente (ou para trás) um número especificado de blocos. |
| TAPE_DRIVE_REVERSE_POSITION | O dispositivo move a fita para trás sobre blocos, marcas de arquivo ou marcas de configuração. |
| TAPE_DRIVE_REWIND_IMMEDIATE | O dispositivo dá suporte à operação de retrocesso imediata. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | O dispositivo move a fita para frente (ou para trás) para a primeira ocorrência de um número especificado de marcas de arquivo consecutivas. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | O dispositivo move a fita para frente (ou para trás) para a primeira ocorrência de um número especificado de setmarks consecutivos. |
| TAPE_DRIVE_SET_BLOCK_SIZE | O dispositivo dá suporte à definição do tamanho de um bloco lógico de comprimento fixo ou à definição do modo de bloco de comprimento variável. |
| TAPE_DRIVE_SET_COMPRESSION | O dispositivo habilita e desabilita a compactação de dados de hardware. |
| TAPE_DRIVE_SET_ECC | O dispositivo habilita e desabilita a correção de erro de hardware. |
| TAPE_DRIVE_SET_PADDING | O dispositivo habilita e desabilita o preenchimento de dados. |
| TAPE_DRIVE_SET_REPORT_SMKS | O dispositivo habilita e desabilita o relatório de setmarks. |
| TAPE_DRIVE_SETMARKS | O dispositivo move a fita para frente (ou inverter) um número especificado de setmarks. |
| TAPE_DRIVE_SPACE_IMMEDIATE | O dispositivo dá suporte ao espaçamento imediato. |
| TAPE_DRIVE_TENSION | O dispositivo dá suporte à tensão de fita. |
| TAPE_DRIVE_TENSION_IMMED | O dispositivo dá suporte à tensão de fita imediata. |
| TAPE_DRIVE_WRITE_FILEMARKS | O dispositivo grava marcas de arquivo. |
| TAPE_DRIVE_WRITE_LONG_FMKS | O dispositivo grava marcas de arquivo longas. |
| TAPE_DRIVE_WRITE_MARK_IMMED | O dispositivo dá suporte à gravação imediata de marcas de arquivo curtas e longas. |
| TAPE_DRIVE_WRITE_SETMARKS | O dispositivo grava setmarks. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | O dispositivo grava marcas de arquivo curtas. |
EOTWarningZoneSize
Indica o tamanho em bytes da zona de aviso inicial no final da fita. O dispositivo retorna uma condição marcar quando entra na zona.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddtape.h (inclua Ntddtape.h, Minitape.h) |