estructura TAPE_GET_DRIVE_PARAMETERS (minitape.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 admite. Cuando el relleno está habilitado, el dispositivo rellena los datos con ceros para mantener el streaming de cinta 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 establecimiento de informes están habilitadas en un dispositivo que lo admite. El dispositivo informa de las marcas establecidas detectadas durante las operaciones de lectura o espacio. Cuando se establece en FALSE, las marcas de establecimiento 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 admitidas por 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 marcador de principio 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 la configuración del tamaño de advertencia de fin de mediana. |
| 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 está protegida por escritura. |
FeaturesHigh
Indica las características adicionales admitidas por esta unidad si TAPE_DRIVE_HIGH_FEATURES está establecida en FeaturesLow. El controlador de minipuerto establece marcas TAPE_DRIVE_XXX para las características admitidas por 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 vuelve en cuanto 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 fin 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 de carga y descarga inmediatas. |
| 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 devuelve tan pronto como 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 inmediata de rebobinado. |
| 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 la creación de informes de marcas de conjunto. |
| TAPE_DRIVE_SETMARKS | El dispositivo mueve la cinta hacia delante (o inverso) un número especificado de marcas de conjunto. |
| 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 conjunto. |
| 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 | minitape.h (incluya Ntddtape.h, Minitape.h) |