Función TapeClassInitialize (minitape.h)

La rutina TapeClassInitialize realiza gran parte de la inicialización del controlador y del dispositivo en nombre de un controlador de miniclase. TapeClassInitialize carga los puntos de entrada del controlador de clase de cinta para las solicitudes de E/S de cinta en la estructura de datos del controlador de miniclase, localiza y reclama dispositivos de cinta no reclamados que admite el controlador de miniclase y asigna e inicializa los recursos del sistema operativo para el controlador de miniclase y sus dispositivos. TapeClassInitialize usa información específica del controlador de miniclase proporcionada en TapeInitData y vuelve a llamar al controlador de miniclase de cinta para operaciones específicas del controlador.

Sintaxis

SCSIPORT_API ULONG TapeClassInitialize(
  [in] PVOID              Argument1,
  [in] PVOID              Argument2,
  [in] PTAPE_INIT_DATA_EX TapeInitData
);

Parámetros

[in] Argument1

Puntero a la información de contexto del controlador que se pasó a la rutina DriverEntry del controlador miniclase de cinta. El formato de la información es específico del sistema operativo y no debe interpretarse mediante un controlador de miniclase de cinta.

[in] Argument2

Puntero a la segunda estructura de contexto del controlador que se pasó a la rutina DriverEntry del controlador miniclase de cinta. El formato de la información es específico del sistema operativo y no debe interpretarse mediante un controlador de miniclase de cinta.

[in] TapeInitData

Puntero a una estructura de TAPE_INIT_DATA_EX que contiene información específica del controlador, como los puntos de entrada de las rutinas de procesamiento de comandos del controlador miniclase de cinta.

Valor devuelto

TapeClassInitialize devuelve un valor que indica el éxito o error de la inicialización del controlador. El controlador de miniclase de cinta pasa este valor, sin interpretar, como valor devuelto de su rutina DriverEntry .

Comentarios

Un controlador de miniclase de cinta llama a TapeClassInitialize desde su rutina DriverEntry y pasa información específica del controlador en TapeInitData. TapeClassInitialize realiza una gran parte de la inicialización del controlador en nombre del controlador de miniclase y aísla al controlador de miniclase de detalles específicos del sistema operativo.

TapeClassInitialize llama al controlador de miniclase de cinta para las actividades específicas del controlador necesarias durante la inicialización. Por ejemplo, TapeClassInitialize llama a la rutina TapeMiniVerifyInquiry del controlador de miniclase de cinta para determinar si el controlador admite un dispositivo de cinta determinado. TapeClassInitialize también llama a la rutina TapeMiniExtensionInit del controlador de miniclase de cinta para inicializar la extensión de minitape, si el controlador de miniclase solicitó uno.

Un controlador de miniclase de cinta asigna una estructura de TAPE_INIT_DATA_EX en la pila, lo borra con TapeClassZeroMemory, rellena todos los miembros adecuados y lo pasa a TapeClassInitialize.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	minitape.h (incluye Minitape.h)
Library	Tape.lib

Consulte también

DriverEntry of Tape Miniclass Driver

TAPE_INIT_DATA_EX