Función CreateTapePartition (winbase.h)

  • Artículo

La función CreateTapePartition vuelve a formatear una cinta.

Sintaxis

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Parámetros

[in] hDevice

Controle al dispositivo donde se va a crear la nueva partición. Este identificador se crea mediante la función CreateFile .

[in] dwPartitionMethod

Tipo de partición que se va a crear. Para determinar qué tipo de particiones admite el dispositivo, consulte la documentación del hardware. Este parámetro puede tener uno de los siguientes valores.

Valor Significado
TAPE_FIXED_PARTITIONS
0L
 Particiona la cinta en función de la definición predeterminada del dispositivo de las particiones. Se omiten los parámetros dwCount y dwSize .
TAPE_INITIATOR_PARTITIONS
T2l
 Divide la cinta en el número y el tamaño de las particiones especificadas por dwCount y dwSize, respectivamente, excepto en la última partición. El tamaño de la última partición es el resto de la cinta.
TAPE_SELECT_PARTITIONS
1 L
 Divide la cinta en el número de particiones especificadas por dwCount. Se omite el parámetro dwSize . El tamaño de las particiones viene determinado por el tamaño de partición predeterminado del dispositivo. Para obtener información más específica, consulte la documentación del dispositivo de cinta.

[in] dwCount

Número de particiones que se van a crear. La función GetTapeParameters proporciona el número máximo de particiones que puede admitir una cinta.

[in] dwSize

Tamaño de cada partición, en megabytes. Este valor se omite si el parámetro dwPartitionMethod está TAPE_SELECT_PARTITIONS.

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_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_SETMARK_DETECTED
1103L
 Se alcanzó una marca de establecimiento durante una operación.
ERROR_NO_DATA_DETECTED
1104L
 Se alcanzó el marcador de fin de datos durante una operación.
ERROR_PARTITION_FAILURE
1105L
 No se pudo crear particiones en la cinta.
ERROR_INVALID_BLOCK_LENGTH
1106L
 El tamaño del bloque es incorrecto en una nueva cinta en una partición multivolume.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 No se encontró la información de partición cuando se cargaba una cinta.
ERROR_MEDIA_CHANGED
1110L
 La cinta que estaba en la unidad se ha reemplazado o quitado.
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_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

La creación de particiones vuelve a formatear la cinta. Toda la información anterior registrada en la cinta se destruye.

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

GetTapeParameters