Função CreateTapePartition (winbase.h)

  • Artigo

A função CreateTapePartition reformata uma fita.

Sintaxe

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Parâmetros

[in] hDevice

Manipule para o dispositivo em que a nova partição deve ser criada. Esse identificador é criado usando a função CreateFile .

[in] dwPartitionMethod

Tipo de partição a ser criada. Para determinar que tipo de partições seu dispositivo dá suporte, consulte a documentação do hardware. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
TAPE_FIXED_PARTITIONS
0L
 Particiona a fita com base na definição padrão de partições do dispositivo. Os parâmetros dwCount e dwSize são ignorados.
TAPE_INITIATOR_PARTITIONS
2L
 Particiona a fita no número e no tamanho das partições especificadas por dwCount e dwSize, respectivamente, exceto pela última partição. O tamanho da última partição é o restante da fita.
TAPE_SELECT_PARTITIONS
1L
 Particiona a fita no número de partições especificadas por dwCount. O parâmetro dwSize é ignorado. O tamanho das partições é determinado pelo tamanho de partição padrão do dispositivo. Para obter informações mais específicas, consulte a documentação do dispositivo de fita.

[in] dwCount

Número de partições a serem criadas. A função GetTapeParameters fornece o número máximo de partições que uma fita pode dar suporte.

[in] dwSize

Tamanho de cada partição, em megabytes. Esse valor será ignorado se o parâmetro dwPartitionMethod for TAPE_SELECT_PARTITIONS.

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_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_SETMARK_DETECTED
1103L
 Uma marca de definição foi atingida durante uma operação.
ERROR_NO_DATA_DETECTED
1104L
 O marcador de fim de dados foi atingido durante uma operação.
ERROR_PARTITION_FAILURE
1105L
 A fita não pôde ser particionada.
ERROR_INVALID_BLOCK_LENGTH
1106L
 O tamanho do bloco está incorreto em uma nova fita em uma partição multivolume.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 Não foi possível encontrar as informações de partição quando uma fita estava sendo carregada.
ERROR_MEDIA_CHANGED
1110L
 A fita que estava na unidade foi substituída ou removida.
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_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

A criação de partições reformata a fita. Todas as informações anteriores gravadas na fita são destruídas.

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

GetTapeParameters