Función SetTapeParameters (winbase.h)

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