estructura TAPE_INIT_DATA_EX (minitape.h)

Artículo
03/08/2023

TAPE_INIT_DATA_EX define valores y rutinas específicos de un controlador de miniclase de cinta de Windows 2000. La rutina DriverEntry de miniclase de cinta pasa esta información al controlador de clase de cinta para completar la inicialización del controlador de miniclase.

Sintaxis

typedef struct _TAPE_INIT_DATA_EX {
  ULONG                        InitDataSize;
  TAPE_VERIFY_INQUIRY_ROUTINE  VerifyInquiry;
  BOOLEAN                      QueryModeCapabilitiesPage;
  ULONG                        MinitapeExtensionSize;
  TAPE_EXTENSION_INIT_ROUTINE  ExtensionInit;
  ULONG                        DefaultTimeOutValue;
  TAPE_ERROR_ROUTINE           TapeError;
  ULONG                        CommandExtensionSize;
  TAPE_PROCESS_COMMAND_ROUTINE CreatePartition;
  TAPE_PROCESS_COMMAND_ROUTINE Erase;
  TAPE_PROCESS_COMMAND_ROUTINE GetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE GetStatus;
  TAPE_PROCESS_COMMAND_ROUTINE Prepare;
  TAPE_PROCESS_COMMAND_ROUTINE SetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE WriteMarks;
  TAPE_PROCESS_COMMAND_ROUTINE PreProcessReadWrite;
  TAPE_PROCESS_COMMAND_ROUTINE TapeGetMediaTypes;
  ULONG                        MediaTypesSupported;
  TAPE_PROCESS_COMMAND_ROUTINE TapeWMIOperations;
  ULONG                        Reserved[2];
} TAPE_INIT_DATA_EX, *PTAPE_INIT_DATA_EX;

Miembros

InitDataSize

Tamaño de esta estructura, en bytes.

VerifyInquiry

Especifica el punto de entrada de la rutina TapeMiniVerifyInquiry del controlador de miniclase de cinta, que determina si el controlador admite un dispositivo determinado. Esta rutina es necesaria.

QueryModeCapabilitiesPage

Dirige el controlador de clase de cinta cuando TRUE para pasar una página de funcionalidades de modo a las rutinas TapeMiniVerifyInquiry y TapeMiniExtensionInit del controlador de miniclase de cinta.

MinitapeExtensionSize

Especifica el tamaño, en bytes, de un área de contexto específica del controlador. Si este miembro no es cero, ExtensionInit no debe ser NULL. Este valor es opcional y debe establecerse en cero si no se usa.

ExtensionInit

Puntero a la rutina TapeMiniExtensionInit del controlador de miniclase de cinta, que inicializa una extensión de minitape opcional, si existe. Si MiniTapeExtensionSize es cero, ExtensionInit debe ser NULL.

DefaultTimeOutValue

Especifica el número de segundos que el controlador de clase de cinta espera para una solicitud SRB antes de cancelarla. Si este valor es cero, el controlador de clase de cinta establece un valor predeterminado adecuado. El controlador de clase de cinta siempre usa el valor de tiempo de espera predeterminado para las solicitudes de lectura y escritura. Las rutinas contenidas en la estructura de TAPE_INIT_DATA_EX pueden invalidar el valor de tiempo de espera predeterminado para las solicitudes de control de dispositivos estableciendo TimeOutValue en una SRB.

TapeError

Puntero a la rutina TapeMiniTapeError del controlador de miniclase de cinta, que aumenta las actividades de control de errores del controlador de clase de cinta. Esta rutina es opcional. Si no se usa una, TapeError debe establecerse en NULL.

CommandExtensionSize

Especifica el tamaño, en bytes, de una extensión de comando que se va a asignar antes del inicio de cada comando de cinta. Un controlador de miniclase de cinta usa la extensión de comando para almacenar el contexto durante el procesamiento de comandos de cinta. Su tamaño y estructura interna se definen mediante el controlador de miniclase de cinta. Una extensión de comando es opcional. Si no se usa uno, CommandExtensionSize debe establecerse en cero.

CreatePartition

Puntero a la rutina TapeMiniCreatePartition del controlador de miniclase de cinta, que crea una partición en una cinta. Esta rutina es necesaria.

Erase

Puntero a la rutina TapeMiniErase del controlador de miniclase de cinta, que borra una cinta. Esta rutina es necesaria.

GetDriveParameters

Puntero a la rutina TapeMiniGetDriveParameters del controlador de miniclase de cinta, que controla las solicitudes para obtener parámetros de unidad. Esta rutina es necesaria.

GetMediaParameters

Puntero a la rutina TapeMiniGetMediaParameters del controlador de miniclase de cinta, que controla las solicitudes para obtener parámetros multimedia. Esta rutina es necesaria.

GetPosition

Puntero a la rutina TapeMiniGetPosition del controlador de miniclase de cinta, que controla las solicitudes para obtener la posición de una cinta. Esta rutina es necesaria.

GetStatus

Puntero a la rutina TapeMiniGetStatus del controlador de miniclase de cinta, que controla las solicitudes de estado. Esta rutina es necesaria.

Prepare

Puntero a la rutina TapeMiniPrepare del controlador de miniclase de cinta, que prepara un dispositivo de cinta. Esta rutina es necesaria.

SetDriveParameters

Puntero a la rutina TapeMiniSetDriveParameters del controlador de miniclase de cinta, que establece parámetros de unidad. Esta rutina es necesaria.

SetMediaParameters

Puntero a la rutina TapeMiniSetMediaParameters del controlador de miniclase de cinta, que establece parámetros multimedia. Esta rutina es necesaria.

SetPosition

Puntero a la rutina TapeMiniSetPosition del controlador de miniclase de cinta, que coloca una cinta. Esta rutina es necesaria.

WriteMarks

Puntero a la rutina TapeMiniWriteMarks del controlador de miniclase de cinta, que escribe marcas en cinta. Esta rutina es necesaria.

PreProcessReadWrite

Puntero a la rutina TapeMiniPreProcessReadWrite del controlador de miniclase de cinta, que ejecuta operaciones específicas del dispositivo antes de todas las lecturas y escrituras. Esta rutina es opcional y no es necesaria para la mayoría de los controladores. Si no se usa, PreProcessReadWrite debe ser NULL.

TapeGetMediaTypes

Puntero a la rutina TapeMiniGetMediaTypes del controlador de miniclase de cinta, que obtiene una descripción de cada tipo de medio admitido por un dispositivo de cinta. Esta rutina es necesaria.

MediaTypesSupported

Indica el número de tipos de medios admitidos por el dispositivo.

TapeWMIOperations

Puntero a la rutina TapeMiniWMIControl .

Reserved[2]

Reservado.

Comentarios

Una rutina DriverEntry del controlador de miniclase de cinta llama a TapeClassZeroMemory para borrar TAPE_INIT_DATA_EX, rellena los miembros necesarios y los miembros opcionales adecuados, y TapeClassInitialize con un puntero a esta estructura.

Los nombres de las rutinas del controlador de miniclase de cinta indicadas en las descripciones de miembros de esta estructura son simplemente nombres de marcador de posición. El prototipo de estas rutinas se declara en newtape.h como TAPE_PROCESS_COMMAND_ROUTINE.

El significado de los parámetros de este prototipo es diferente para cada rutina de controlador de miniclase. Para obtener información detallada sobre cómo se usan estos parámetros, consulte las descripciones de cada rutina de controlador de miniclase individual.