Função PrepareTape (winbase.h)

  • Artigo

A função PrepareTape prepara a fita a ser acessada ou removida.

Sintaxe

DWORD PrepareTape(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] BOOL   bImmediate
);

Parâmetros

[in] hDevice

Manipule para o dispositivo que prepara a fita. Esse identificador é criado usando a função CreateFile .

[in] dwOperation

Preparação do dispositivo de fita. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
TAPE_FORMAT
5L
 Executa um formato de baixo nível da fita. Atualmente, somente o dispositivo QIC117 dá suporte a esse recurso.
TAPE_LOAD
0L
 Carrega a fita e move a fita para o início.
TAPE_LOCK
3L
 Bloqueia o mecanismo de ejeção de fita para que a fita não seja ejetada acidentalmente.
TAPE_TENSION
2L
 Ajusta a tensão movendo a fita para o final da fita e de volta ao início. Não há suporte para essa opção em todos os dispositivos. Esse valor será ignorado se não houver suporte.
TAPE_UNLOAD
1L
 Move a fita para o início para remoção do dispositivo. Após uma operação de descarregamento bem-sucedida, o dispositivo retorna erros para aplicativos que tentam acessar a fita até que a fita seja carregada novamente.
TAPE_UNLOCK
4L
 Desbloqueia o mecanismo de ejeção de fita.

[in] bImmediate

Se esse parâmetro for TRUE, a função retornará imediatamente. Se for FALSE, a função não retornará até que a operação seja concluída.

Valor retornado

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.

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 barramento.
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 da 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
 A fita não pôde ser particionada.
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

Alguns dispositivos de fita não dão suporte a determinadas operações de fita. Consulte a documentação do dispositivo de fita e use a função GetTapeParameters para determinar os recursos do dispositivo de fita.

Requisitos

   
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 (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CreateFile

GetTapeParameters