Share via

Função WriteTapemark (winbase.h)

  • Artigo

A função WriteTapemark grava um número especificado de marcas de arquivo, setmarks, marcas de arquivo curtas ou marcas de arquivo longas em um dispositivo de fita. Essas marcas de fita dividem uma partição de fita em áreas menores.

Sintaxe

DWORD WriteTapemark(
  [in] HANDLE hDevice,
  [in] DWORD  dwTapemarkType,
  [in] DWORD  dwTapemarkCount,
  [in] BOOL   bImmediate
);

Parâmetros

[in] hDevice

Manipule para o dispositivo no qual gravar as marcas de fita. Esse identificador é criado usando a função CreateFile .

[in] dwTapemarkType

Tipo de tapemarks a serem gravadas. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
TAPE_FILEMARKS
1L
 Grava o número de marcas de arquivo especificadas pelo parâmetro dwTapemarkCount .
TAPE_LONG_FILEMARKS
3L
 Grava o número de marcas de arquivo longas especificadas por dwTapemarkCount.
TAPE_SETMARKS
0L
 Grava o número de setmarks especificado por dwTapemarkCount.
TAPE_SHORT_FILEMARKS
2L
 Grava o número de marcas de arquivo curtas especificadas por dwTapemarkCount.

[in] dwTapemarkCount

Número de marcas de fita a serem gravadas.

[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.

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.

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

Marcas de arquivo, setmarks, marcas de arquivo curtas e marcas de arquivo longas são elementos gravados especiais que denotam a organização linear da fita. Nenhuma dessas marcas contém dados do usuário. As marcas de arquivo são as marcas mais gerais; Os setmarks fornecem uma hierarquia não disponível com marcas de arquivo.

Uma marca de arquivo curta contém uma pequena lacuna de apagamento que não pode ser substituída, a menos que a operação de gravação seja executada desde o início da partição ou de uma marca de arquivo longa anterior.

Uma marca de arquivo longa contém uma lacuna de apagamento longa que permite que um aplicativo posicione a fita no início da marca de arquivo e substitua a marca de arquivo e a lacuna de apagamento.

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

Confira também

CreateFile