Función SetTapeParameters (winbase.h)

  • Artículo

La función SetTapeParameters especifica el tamaño de bloque de una cinta o configura el dispositivo de cinta.

Sintaxis

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

Parámetros

[in] hDevice

Controle al dispositivo para el que se va a establecer la información de configuración. Este identificador se crea mediante la función CreateFile .

[in] dwOperation

Tipo de información que se va a establecer. Este parámetro puede ser uno de los siguientes valores.

Value Significado
SET_TAPE_DRIVE_INFORMATION
1 L
 Establece la información específica del dispositivo especificada por lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION
0L
 Establece la información específica de cinta especificada por el parámetro lpTapeInformation .

[in] lpTapeInformation

Puntero a una estructura que contiene la información que se va a establecer. Si el parámetro dwOperation es SET_TAPE_MEDIA_INFORMATION, lpTapeInformation apunta a una estructura de TAPE_SET_MEDIA_PARAMETERS .

Si dwOperation es SET_TAPE_DRIVE_INFORMATION, lpTapeInformation apunta a una estructura de TAPE_SET_DRIVE_PARAMETERS .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, puede devolver uno de los siguientes códigos de error.

Error Descripción
ERROR_BEGINNING_OF_MEDIA
1102L
 Error al intentar acceder a los datos antes del principio del marcador medio.
ERROR_BUS_RESET
1111L
 Se detectó una condición de restablecimiento en el bus.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 No se encontró la información de partición cuando se cargaba una cinta.
ERROR_END_OF_MEDIA
1100L
 Se alcanzó el marcador final de cinta durante una operación.
ERROR_FILEMARK_DETECTED
1101L
 Se alcanzó una marca de archivo durante una operación.
ERROR_INVALID_BLOCK_LENGTH
1106L
 El tamaño del bloque es incorrecto en una nueva cinta en una partición multivolume.
ERROR_MEDIA_CHANGED
1110L
 La cinta que estaba en la unidad se ha reemplazado o quitado.
ERROR_NO_DATA_DETECTED
1104L
 Se alcanzó el marcador de fin de datos durante una operación.
ERROR_NO_MEDIA_IN_DRIVE
1112L
 No hay ningún medio en la unidad.
ERROR_NOT_SUPPORTED
50L
 El controlador de cinta no admite una función solicitada.
ERROR_PARTITION_FAILURE
1105L
 No se pudo crear particiones en la cinta.
ERROR_SETMARK_DETECTED
1103L
 Se alcanzó una marca de establecimiento durante una operación.
ERROR_UNABLE_TO_LOCK_MEDIA
1108L
 Error al intentar bloquear el mecanismo de expulsión.
ERROR_UNABLE_TO_UNLOAD_MEDIA
1109L
 Error al intentar descargar la cinta.
ERROR_WRITE_PROTECT
19L
 El medio está protegido contra escritura.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS