Função GetTapeParameters (winbase.h)

  • Artigo

A função GetTapeParameters recupera informações que descrevem a fita ou a unidade de fita.

Sintaxe

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Parâmetros

[in] hDevice

Manipule para o dispositivo sobre quais informações são procuradas. Esse identificador é criado usando a função CreateFile .

[in] dwOperation

Tipo de informação solicitada. Esse parâmetro deve usar um dos valores a seguir.

Valor Significado
GET_TAPE_DRIVE_INFORMATION
1
 Recupera informações sobre o dispositivo de fita.
GET_TAPE_MEDIA_INFORMATION
0
 Recupera informações sobre a fita no dispositivo de fita.

[out] lpdwSize

Ponteiro para uma variável que recebe o tamanho, em bytes, do buffer especificado pelo parâmetro lpTapeInformation . Se o buffer for muito pequeno, esse parâmetro receberá o tamanho necessário.

[out] lpTapeInformation

Ponteiro para uma estrutura que contém as informações solicitadas. Se o parâmetro dwOperation for GET_TAPE_MEDIA_INFORMATION, lpTapeInformation apontará para uma estrutura TAPE_GET_MEDIA_PARAMETERS .

Se dwOperation for GET_TAPE_DRIVE_INFORMATION, lpTapeInformation apontará para uma estrutura de TAPE_GET_DRIVE_PARAMETERS .

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, ela poderá retornar um dos seguintes códigos de erro.

Código do erro Descrição
ERROR_BEGINNING_OF_MEDIA
1102L
 Uma tentativa de acessar dados antes do início do marcador médio falhar.
ERROR_BUS_RESET
1111L
 Uma condição de redefinição foi detectada no ônibus.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 Não foi possível encontrar as informações de partição quando uma fita estava sendo carregada.
ERROR_END_OF_MEDIA
1100L
 O marcador de fim de fita foi atingido durante uma operação.
ERROR_FILEMARK_DETECTED
1101L
 Uma marca de arquivo foi atingida durante uma operação.
ERROR_INVALID_BLOCK_LENGTH
1106L
 O tamanho do bloco está incorreto em uma nova fita em uma partição multivolume.
ERROR_MEDIA_CHANGED
1110L
 A fita que estava na unidade foi substituída ou removida.
ERROR_NO_DATA_DETECTED
1104L
 O marcador de fim de dados foi atingido durante uma operação.
ERROR_NO_MEDIA_IN_DRIVE
1112L
 Não há mídia na unidade.
ERROR_NOT_SUPPORTED
50L
 O driver de fita não dá suporte a uma função solicitada.
ERROR_PARTITION_FAILURE
1105L
 Não foi possível particionar a fita.
ERROR_SETMARK_DETECTED
1103L
 Uma marca de definição foi atingida durante uma operação.
ERROR_UNABLE_TO_LOCK_MEDIA
1108L
 Falha ao tentar bloquear o mecanismo de ejeção.
ERROR_UNABLE_TO_UNLOAD_MEDIA
1109L
 Falha ao tentar descarregar a fita.
ERROR_WRITE_PROTECT
19L
 A mídia está protegida contra gravação.

Comentários

Os valores de intervalo de tamanho de bloco (máximo e mínimo) retornados pela função GetTapeParameters chamada com o parâmetro dwOperation definido como o valor GET_TAPE_DRIVE_INFORMATION indicarão limites do sistema, não limites de unidade. No entanto, é o dispositivo de unidade de fita e a mídia presente na unidade que determinam os limites de tamanho de bloco verdadeiros. Portanto, um aplicativo pode não ser capaz de definir todos os tamanhos de bloco mencionados no intervalo obtido especificando GET_TAPE_DRIVE_INFORMATION em dwOperation.

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]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CreateFile

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS