estructura TAPE_GET_DRIVE_PARAMETERS (ntddtape.h)
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) |