estrutura TAPE_GET_DRIVE_PARAMETERS (winnt.h)

Artigo
03/08/2023

A estrutura TAPE_GET_DRIVE_PARAMETERS descreve a unidade de fita. Ele é usado pela função GetTapeParameters .

Sintaxe

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;

Membros

ECC

Se esse membro for TRUE, o dispositivo oferecerá suporte à correção de erro de hardware. Caso contrário, isso não acontece.

Compression

Se esse membro for TRUE, a compactação de dados de hardware estará habilitada. Caso contrário, ele será desabilitado.

DataPadding

Se esse membro for TRUE, o preenchimento de dados será habilitado. Caso contrário, ele será desabilitado. O preenchimento de dados mantém o streaming de fita em uma velocidade constante.

ReportSetmarks

Se esse membro for TRUE, o relatório de marca de definição será habilitado. Caso contrário, ele será desabilitado.

DefaultBlockSize

Tamanho de bloco fixo padrão do dispositivo, em bytes.

MaximumBlockSize

Tamanho máximo do bloco do dispositivo, em bytes.

MinimumBlockSize

Tamanho mínimo do bloco do dispositivo, em bytes.

MaximumPartitionCount

Número máximo de partições que podem ser criadas no dispositivo.

FeaturesLow

Bits de baixa ordem do sinalizador de recursos do dispositivo. Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
TAPE_DRIVE_COMPRESSION 0x00020000	O dispositivo dá suporte à compactação de dados de hardware.
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	O dispositivo poderá relatar se a limpeza for necessária.
TAPE_DRIVE_ECC 0x00010000	O dispositivo dá suporte à correção de erro de hardware.
TAPE_DRIVE_EJECT_MEDIA 0x01000000	O dispositivo ejeta fisicamente a fita em um software ejetado.
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	O dispositivo executa a operação de apagamento somente do marcador de início de partição.
TAPE_DRIVE_ERASE_LONG 0x00000020	O dispositivo executa uma operação de apagamento longa.
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	O dispositivo executa uma operação de apagamento imediato, ou seja, retorna quando a operação de apagamento é iniciada.
TAPE_DRIVE_ERASE_SHORT 0x00000010	O dispositivo executa uma operação de apagamento curto.
TAPE_DRIVE_FIXED 0x00000001	O dispositivo cria partições de dados fixas.
TAPE_DRIVE_FIXED_BLOCK 0x00000400	O dispositivo dá suporte ao modo de bloco de comprimento fixo.
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	O dispositivo fornece o endereço de bloco específico do dispositivo atual.
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	O dispositivo fornece o endereço de bloco lógico atual (e a partição de fita lógica).
TAPE_DRIVE_INITIATOR 0x00000004	O dispositivo cria partições definidas pelo iniciador.
TAPE_DRIVE_PADDING 0x00040000	O dispositivo dá suporte ao preenchimento de dados.
TAPE_DRIVE_REPORT_SMKS 0x00080000	O dispositivo dá suporte a relatórios de marca de definição.
TAPE_DRIVE_SELECT 0x00000002	O dispositivo cria partições de dados selecionadas.
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	O dispositivo deve estar no início de uma partição antes de poder definir a compactação.
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	O dispositivo dá suporte à configuração do tamanho de aviso de fim de médio.
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	O dispositivo retorna a capacidade máxima da fita.
TAPE_DRIVE_TAPE_REMAINING 0x00000200	O dispositivo retorna a capacidade restante da fita.
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	O dispositivo dá suporte ao modo de bloco de comprimento variável.
TAPE_DRIVE_WRITE_PROTECT 0x00001000	O dispositivo retornará um erro se a fita estiver habilitada para gravação ou protegida por gravação.

FeaturesHigh

Bits de alta ordem do sinalizador de recursos do dispositivo. Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	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 0x80001000	O dispositivo move a fita para um endereço de bloco específico do dispositivo.
TAPE_DRIVE_END_OF_DATA 0x80010000	O dispositivo move a fita para o marcador de fim de dados em uma partição.
TAPE_DRIVE_FILEMARKS 0x80040000	O dispositivo move a fita para frente (ou para trás) um número especificado de marcas de arquivo.
TAPE_DRIVE_LOAD_UNLOAD 0x80000001	O dispositivo habilita e desabilita o dispositivo para operações adicionais.
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	O dispositivo dá suporte a operações imediatas de carregamento e descarregamento.
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	O dispositivo habilita e desabilita o mecanismo de ejeção de fita.
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	O dispositivo dá suporte a operações imediatas de bloqueio e desbloqueio.
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	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 0x80004000	O dispositivo move a fita para um endereço de bloco lógico em uma partição.
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	O dispositivo move a fita para frente (ou para trás) um número especificado de blocos.
TAPE_DRIVE_REVERSE_POSITION 0x80400000	O dispositivo move a fita para trás sobre blocos, marcas de arquivo ou marcas de configuração.
TAPE_DRIVE_REWIND_IMMEDIATE 0x80000008	O dispositivo dá suporte à operação de retrocesso imediata.
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	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 0x80200000	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 0x80000010	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 0x80000200	O dispositivo habilita e desabilita a compactação de dados de hardware.
TAPE_DRIVE_SET_ECC 0x80000100	O dispositivo habilita e desabilita a correção de erro de hardware.
TAPE_DRIVE_SET_PADDING 0x80000400	O dispositivo habilita e desabilita o preenchimento de dados.
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	O dispositivo habilita e desabilita o relatório de setmarks.
TAPE_DRIVE_SETMARKS 0x80100000	O dispositivo move a fita para frente (ou inverter) um número especificado de setmarks.
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	O dispositivo dá suporte ao espaçamento imediato.
TAPE_DRIVE_TENSION 0x80000002	O dispositivo dá suporte à tensão de fita.
TAPE_DRIVE_TENSION_IMMED 0x80000040	O dispositivo dá suporte à tensão de fita imediata.
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	O dispositivo grava marcas de arquivo.
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	O dispositivo grava marcas de arquivo longas.
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	O dispositivo dá suporte à gravação imediata de marcas de arquivo curtas e longas.
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	O dispositivo grava setmarks.
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	O dispositivo grava marcas de arquivo curtas.

EOTWarningZoneSize

Indica o número de bytes entre o aviso de fim da fita e o final físico da fita.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winnt.h (inclua Windows.h)

Confira também

GetTapeParameters

Share via