Función GetTapeStatus (winbase.h)

  • Artículo

La función GetTapeStatus determina si el dispositivo de cinta está listo para procesar comandos de cinta.

Sintaxis

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

Parámetros

[in] hDevice

Identificador del dispositivo para el que se va a obtener el estado del dispositivo. Este identificador se crea mediante la función CreateFile .

Valor devuelto

Si el dispositivo de cinta está listo para aceptar los comandos de acceso a cinta adecuados sin devolver errores, el valor devuelto se NO_ERROR.

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

Código de 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_DEVICE_REQUIRES_CLEANING
1165L
 La unidad de cinta es capaz de informar de que requiere limpieza e informa de que requiere limpieza.
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

Requisito Value
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

CreateFile