Função SetTapeParameters (winbase.h)

Artigo
08/27/2023

A função SetTapeParameters especifica o tamanho do bloco de uma fita ou configura o dispositivo de fita.

Sintaxe

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

Parâmetros

[in] hDevice

Manipule para o dispositivo para o qual definir informações de configuração. Esse identificador é criado usando a função CreateFile .

[in] dwOperation

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

Valor	Significado
SET_TAPE_DRIVE_INFORMATION 1L	Define as informações específicas do dispositivo especificadas por lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION 0L	Define as informações específicas da fita especificadas pelo parâmetro lpTapeInformation .

[in] lpTapeInformation

Ponteiro para uma estrutura que contém as informações a serem definidas. Se o parâmetro dwOperation for SET_TAPE_MEDIA_INFORMATION, lpTapeInformation apontará para uma estrutura TAPE_SET_MEDIA_PARAMETERS .

Se dwOperation for SET_TAPE_DRIVE_INFORMATION, lpTapeInformation apontará para uma estrutura TAPE_SET_DRIVE_PARAMETERS .

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

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

Confira também

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS

Compartilhar via