Función GetTapeParameters (winbase.h)

  • Artículo

La función GetTapeParameters recupera información que describe la cinta o la unidad de cinta.

Sintaxis

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Parámetros

[in] hDevice

Controle al dispositivo sobre qué información se busca. Este identificador se crea mediante la función CreateFile .

[in] dwOperation

Tipo de información solicitada. Este parámetro puede ser uno de los siguientes valores.

Value Significado
GET_TAPE_DRIVE_INFORMATION
1
 Recupera información sobre el dispositivo de cinta.
GET_TAPE_MEDIA_INFORMATION
0
 Recupera información sobre la cinta en el dispositivo de cinta.

[out] lpdwSize

Puntero a una variable que recibe el tamaño, en bytes, del búfer especificado por el parámetro lpTapeInformation . Si el búfer es demasiado pequeño, este parámetro recibe el tamaño necesario.

[out] lpTapeInformation

Puntero a una estructura que contiene la información solicitada. Si el parámetro dwOperation es GET_TAPE_MEDIA_INFORMATION, lpTapeInformation apunta a una estructura de TAPE_GET_MEDIA_PARAMETERS .

Si dwOperation es GET_TAPE_DRIVE_INFORMATION, lpTapeInformation apunta a una estructura de TAPE_GET_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.

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

Comentarios

Los valores de intervalo de tamaño de bloque (máximo y mínimo) devueltos por la función GetTapeParameters llamada con el parámetro dwOperation establecido en el valor de GET_TAPE_DRIVE_INFORMATION indicarán los límites del sistema, no los límites de unidad. Sin embargo, es el dispositivo de unidad de cinta y los medios presentes en la unidad que determinan los límites de tamaño de bloque verdaderos. Por lo tanto, es posible que una aplicación no pueda establecer todos los tamaños de bloque mencionados en el intervalo obtenido especificando GET_TAPE_DRIVE_INFORMATION en dwOperation.

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

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS