Compartir a través de

estructura TAPE_GET_DRIVE_PARAMETERS (ntddtape.h)

  • Artículo

La estructura TAPE_GET_DRIVE_PARAMETERS se usa junto con la solicitud de IOCTL_TAPE_GET_DRIVE_PARAMS para recuperar información sobre las funcionalidades de la unidad de cinta.

Sintaxis

typedef struct _TAPE_GET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  ULONG   DefaultBlockSize;
  ULONG   MaximumBlockSize;
  ULONG   MinimumBlockSize;
  ULONG   MaximumPartitionCount;
  ULONG   FeaturesLow;
  ULONG   FeaturesHigh;
  ULONG   EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;

Miembros

ECC

Cuando se establece en TRUE, indica que el dispositivo usa la corrección de errores de hardware.

Compression

Cuando se establece en TRUE, indica que la compresión está habilitada en un dispositivo que lo admite. Cuando la compresión está habilitada, el dispositivo comprime los datos antes de escribirlos. Cuando se establece en FALSE, la compresión no está habilitada en el dispositivo.

DataPadding

Cuando se establece en TRUE, indica que el relleno de datos está habilitado en un dispositivo que lo admita. Cuando se habilita el relleno, el dispositivo rellena los datos con ceros para mantener el streaming de cintas hasta que los datos estén listos. Cuando se establece en FALSE, el relleno de datos no está habilitado.

ReportSetmarks

Cuando se establece en TRUE, indica que las marcas de conjunto de informes están habilitadas en un dispositivo que lo admita. El dispositivo informa de las marcas establecidas detectadas durante las operaciones de lectura o espacio. Cuando se establece en FALSE, las marcas de conjunto de informes no están habilitadas.

DefaultBlockSize

Indica el tamaño de bloque predeterminado, en bytes.

MaximumBlockSize

Indica el tamaño máximo de bloque, en bytes, del dispositivo de cinta o del adaptador de bus host subyacente (HBA), lo que sea menor.

MinimumBlockSize

Indica el tamaño mínimo de bloque, en bytes.

MaximumPartitionCount

Indica el número máximo de particiones que admite el dispositivo.

FeaturesLow

Indica las características admitidas por esta unidad. El controlador de minipuerto establece marcas TAPE_DRIVE_XXX para las características compatibles con la unidad y borra las marcas para las características que no se admiten. Los autores de llamadas pueden usar las máscaras TAPE_DRIVE_XXX definidas en minitape.h para determinar si una unidad admite una característica determinada. Las máscaras disponibles son las siguientes:

Máscara Significado
TAPE_DRIVE_CLEAN_REQUESTS El dispositivo puede notificar si requiere limpieza.
TAPE_DRIVE_COMPRESSION El dispositivo admite la compresión de datos de hardware.
TAPE_DRIVE_ECC El dispositivo admite la corrección de errores de hardware.
TAPE_DRIVE_EJECT_MEDIA El dispositivo expulsa el medio.
TAPE_DRIVE_EOT_WZ_SIZE El dispositivo puede notificar el final del tamaño de advertencia de zona.
TAPE_DRIVE_ERASE_BOP_ONLY El dispositivo realiza la operación de borrado solo desde el principio del marcador de partición.
TAPE_DRIVE_ERASE_IMMEDIATE ¿El dispositivo realiza una operación de borrado inmediata?? es decir, devuelve cuando comienza la operación de borrado.
TAPE_DRIVE_ERASE_LONG El dispositivo realiza una operación de borrado larga.
TAPE_DRIVE_ERASE_SHORT El dispositivo realiza una operación de borrado corta.
TAPE_DRIVE_FIXED El dispositivo crea particiones de datos fijas.
TAPE_DRIVE_FIXED_BLOCK El dispositivo admite el modo de bloque de longitud fija.
TAPE_DRIVE_INITIATOR El dispositivo crea particiones definidas por el iniciador.
TAPE_DRIVE_GET_ABSOLUTE_BLK El dispositivo proporciona la dirección de bloque específica del dispositivo actual.
TAPE_DRIVE_GET_LOGICAL_BLK El dispositivo proporciona la dirección del bloque lógico actual (y la partición de cinta lógica).
TAPE_DRIVE_PADDING El dispositivo admite el relleno de datos.
TAPE_DRIVE_REPORT_SMKS El dispositivo admite la creación de informes setmark.
TAPE_DRIVE_RESERVED_BIT Máscara que identifica un bit reservado. Los controladores no deben establecer este bit.
TAPE_DRIVE_SELECT El dispositivo crea particiones de datos selectas.
TAPE_DRIVE_SET_CMP_BOP_ONLY El dispositivo solo permite habilitar la compresión cuando el encabezado de lectura y escritura está al principio de la partición.
TAPE_DRIVE_SET_EOT_WZ_SIZE El dispositivo admite el establecimiento del tamaño de advertencia de final de medio.
TAPE_DRIVE_TAPE_CAPACITY El dispositivo devuelve la capacidad máxima de la cinta.
TAPE_DRIVE_TAPE_REMAINING El dispositivo devuelve la capacidad restante de la cinta.
TAPE_DRIVE_VARIABLE_BLOCK El dispositivo admite el modo de bloque de longitud variable.
TAPE_DRIVE_WRITE_PROTECT El dispositivo devuelve un error si la cinta está habilitada para escritura o protegida con escritura.

FeaturesHigh

Indica las características adicionales admitidas por esta unidad si TAPE_DRIVE_HIGH_FEATURES se establece en FeaturesLow. El controlador de minipuerto establece marcas TAPE_DRIVE_XXX para las características compatibles con la unidad y borra las marcas para las características que no se admiten. Los autores de llamadas pueden usar las máscaras TAPE_DRIVE_XXX definidas en minitape.h para determinar si una unidad admite una característica determinada.

Máscara Significado
TAPE_DRIVE_ABS_BLK_IMMED El dispositivo mueve la cinta a una dirección de bloque específica del dispositivo y devuelve tan pronto como comienza el movimiento.
TAPE_DRIVE_ABSOLUTE_BLK El dispositivo mueve la cinta a una dirección de bloque específica del dispositivo.
TAPE_DRIVE_END_OF_DATA El dispositivo mueve la cinta al marcador de extremo de datos en una partición.
TAPE_DRIVE_FILEMARKS El dispositivo mueve la cinta hacia delante (o hacia atrás) un número especificado de marcas de archivo.
TAPE_DRIVE_FORMAT El dispositivo puede dar formato al medio.
TAPE_DRIVE_FORMAT_IMMEDIATE El dispositivo puede dar formato al medio como un comando inmediato.
TAPE_DRIVE_HIGH_FEATURES Máscara de bits que indica los bits que corresponden a características altas.
TAPE_DRIVE_LOAD_UNLOAD El dispositivo habilita y deshabilita el dispositivo para realizar más operaciones.
TAPE_DRIVE_LOAD_UNLD_IMMED El dispositivo admite operaciones inmediatas de carga y descarga.
TAPE_DRIVE_LOCK_UNLOCK El dispositivo habilita y deshabilita el mecanismo de ejección de cinta.
TAPE_DRIVE_LOCK_UNLK_IMMED El dispositivo admite operaciones inmediatas de bloqueo y desbloqueo.
TAPE_DRIVE_LOG_BLK_IMMED El dispositivo mueve la cinta a una dirección de bloque lógico en una partición y vuelve en cuanto comienza el movimiento.
TAPE_DRIVE_LOGICAL_BLK El dispositivo mueve la cinta a una dirección de bloque lógico en una partición.
TAPE_DRIVE_RELATIVE_BLKS El dispositivo mueve la cinta hacia delante (o hacia atrás) un número especificado de bloques.
TAPE_DRIVE_REVERSE_POSITION El dispositivo mueve la cinta hacia atrás sobre bloques, marcas de archivo o marcas de conjunto.
TAPE_DRIVE_REWIND_IMMEDIATE El dispositivo admite la operación de rebobinado inmediata.
TAPE_DRIVE_SEQUENTIAL_FMKS El dispositivo mueve la cinta hacia delante (o hacia atrás) a la primera aparición de un número especificado de marcas de archivo consecutivas.
TAPE_DRIVE_SEQUENTIAL_SMKS El dispositivo mueve la cinta hacia delante (o hacia atrás) a la primera aparición de un número especificado de marcas de conjunto consecutivas.
TAPE_DRIVE_SET_BLOCK_SIZE El dispositivo admite establecer el tamaño de un bloque lógico de longitud fija o establecer el modo de bloque de longitud variable.
TAPE_DRIVE_SET_COMPRESSION El dispositivo habilita y deshabilita la compresión de datos de hardware.
TAPE_DRIVE_SET_ECC El dispositivo habilita y deshabilita la corrección de errores de hardware.
TAPE_DRIVE_SET_PADDING El dispositivo habilita y deshabilita el relleno de datos.
TAPE_DRIVE_SET_REPORT_SMKS El dispositivo habilita y deshabilita los informes de marcas de conjunto.
TAPE_DRIVE_SETMARKS El dispositivo mueve la cinta hacia delante (o inverso) un número especificado de marcas de establecimiento.
TAPE_DRIVE_SPACE_IMMEDIATE El dispositivo admite el espaciado inmediato.
TAPE_DRIVE_TENSION El dispositivo admite la tensión de cinta.
TAPE_DRIVE_TENSION_IMMED El dispositivo admite tensión de cinta inmediata.
TAPE_DRIVE_WRITE_FILEMARKS El dispositivo escribe marcas de archivo.
TAPE_DRIVE_WRITE_LONG_FMKS El dispositivo escribe marcas de archivo largas.
TAPE_DRIVE_WRITE_MARK_IMMED El dispositivo admite la escritura inmediata de marcas de archivo cortas y largas.
TAPE_DRIVE_WRITE_SETMARKS El dispositivo escribe marcas de establecimiento.
TAPE_DRIVE_WRITE_SHORT_FMKS El dispositivo escribe marcas de archivo cortas.

EOTWarningZoneSize

Indica el tamaño en bytes de la zona de advertencia temprana hacia el final de la cinta. El dispositivo devuelve una condición de comprobación cuando entra en la zona.

Requisitos

Requisito Valor
Header ntddtape.h (incluya Ntddtape.h, Minitape.h)

Consulte también

IOCTL_TAPE_GET_DRIVE_PARAMS

TapeMiniGetDriveParameters