TAPE_EXTENSION_INIT_ROUTINE función de devolución de llamada (minitape.h)

Artículo
08/07/2023

ExtensionInit inicializa un área de contexto opcional específica del controlador. TapeClassInitialize llama a esta rutina cuando se carga el controlador de miniclase de cinta. Esta rutina es opcional.

Sintaxis

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

void TapeExtensionInitRoutine(
  [in] PVOID MinitapeExtension,
  [in] PINQUIRYDATA InquiryData,
  [in] PMODE_CAPABILITIES_PAGE ModeCapabilitiesPage
)
{...}

Parámetros

[in] MinitapeExtension

Puntero a un búfer del tamaño solicitado por el controlador de miniclase de cinta cuando se inicializó.

[in] InquiryData

Puntero a los datos de consulta SCSI para el dispositivo de cinta.

[in] ModeCapabilitiesPage

Puntero a un búfer que contiene información de bajo nivel para el dispositivo de cinta. El formato de esta página se define mediante el estándar QIC 157 y está sujeto a cambios. Esto es NULL si el dispositivo no admite una página de funcionalidades de modo.

Valor devuelto

None

Observaciones

Un controlador de miniclase de cinta solicita una extensión de minitape especificando un valor distinto de cero para MinitapeExtensionSize en la estructura de TAPE_INIT_DATA_EX que pasa a TapeClassInitialize desde su rutina DriverEntry . Un controlador de miniclase define la estructura y el contenido de la extensión minitape y normalmente lo usa para almacenar los datos de consulta de los dispositivos que admite.

El controlador de clase de cinta asigna la extensión minitape y la proporciona posteriormente en llamadas a las rutinas del controlador de miniclase de cinta que controlan los aspectos específicos del dispositivo de las solicitudes de control de dispositivo y a la rutina opcional del controlador de miniclase TapeMiniTapeError .

ExtensionInit inicializa la extensión minitape y el controlador de miniclase usa esta área para mantener el estado en tiempo de ejecución de su dispositivo. El controlador de clase de cinta pasa InquiryData y modeCapabilitiesPage a esta rutina porque esas estructuras contienen información que un controlador de miniclase de cinta podría querer almacenar en la extensión minitape.