Share via

Função GetTapeStatus (winbase.h)

  • Artigo

A função GetTapeStatus determina se o dispositivo de fita está pronto para processar comandos de fita.

Sintaxe

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

Parâmetros

[in] hDevice

Manipule para o dispositivo para o qual obter o dispositivo status. Esse identificador é criado usando a função CreateFile .

Retornar valor

Se o dispositivo de fita estiver pronto para aceitar os comandos apropriados de acesso à fita sem retornar erros, 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_DEVICE_REQUIRES_CLEANING
1165L
 A unidade de fita é capaz de relatar que requer limpeza e relata que requer limpeza.
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.

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