Función PrepareTape (winbase.h)

  • Artículo

La función PrepareTape prepara la cinta a la que se va a acceder o quitar.

Sintaxis

DWORD PrepareTape(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] BOOL   bImmediate
);

Parámetros

[in] hDevice

Controle al dispositivo que prepara la cinta. Este identificador se crea mediante la función CreateFile .

[in] dwOperation

Preparación del dispositivo de cinta. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
TAPE_FORMAT
5L
 Realiza un formato de bajo nivel de la cinta. Actualmente, solo el dispositivo QIC117 admite esta característica.
TAPE_LOAD
0L
 Carga la cinta y mueve la cinta al principio.
TAPE_LOCK
3L
 Bloquea el mecanismo de ejección de cinta para que la cinta no se expulse accidentalmente.
TAPE_TENSION
T2l
 Ajusta la tensión moviendo la cinta al final de la cinta y volviendo al principio. Esta opción no es compatible con todos los dispositivos. Este valor se omite si no se admite.
TAPE_UNLOAD
1 L
 Mueve la cinta al principio para su eliminación del dispositivo. Después de una operación de descarga correcta, el dispositivo devuelve errores a las aplicaciones que intentan acceder a la cinta, hasta que la cinta se vuelve a cargar.
TAPE_UNLOCK
4L
 Desbloquea el mecanismo de ejección de cinta.

[in] bImmediate

Si este parámetro es TRUE, la función devuelve inmediatamente. Si es FALSE, la función no devuelve hasta que se haya completado la operación.

Valor devuelto

Si la función se realiza 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 marcador inicial de 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
 El marcador de fin de cinta se alcanzó 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 multivolumen.
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.

Comentarios

Algunos dispositivos de cinta no admiten ciertas operaciones de cinta. Consulte la documentación del dispositivo de cinta y use la función GetTapeParameters para determinar las funcionalidades del dispositivo de cinta.

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 (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CreateFile

GetTapeParameters