TAPE_EXTENSION_INIT_ROUTINE função de retorno de chamada (minitape.h)

Artigo
02/26/2024

ExtensionInit inicializa uma área de contexto opcional específica do driver. Essa rotina é chamada por TapeClassInitialize quando o driver de miniclasse de fita é carregado. Essa rotina é opcional.

Sintaxe

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

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

Parâmetros

[in] MinitapeExtension

Ponteiro para um buffer do tamanho solicitado pelo driver de miniclasse de fita quando inicializado.

[in] InquiryData

Ponteiro para os dados de consulta SCSI para o dispositivo de fita.

[in] ModeCapabilitiesPage

Ponteiro para um buffer que contém informações de baixo nível para o dispositivo de fita. O formato desta página é definido pelo padrão QIC 157 e está sujeito a alterações. Isso será NULL se o dispositivo não der suporte a uma página de recursos de modo.

Retornar valor

Nenhum

Comentários

Um driver de miniclasse de fita solicita uma extensão de minitape especificando um valor diferente de zero para MinitapeExtensionSize na estrutura TAPE_INIT_DATA_EX que ele passa para TapeClassInitialize de sua rotina DriverEntry . Um driver de miniclasse define a estrutura e o conteúdo da extensão de minitape e normalmente a usa para armazenar dados de consulta para os dispositivos aos quais ele dá suporte.

O driver de classe de fita aloca a extensão de minitape e a fornece posteriormente em chamadas para as rotinas do driver de miniclasse de fita que lidam com os aspectos específicos do dispositivo das solicitações de controle de dispositivo e para a rotina opcional TapeMiniTapeError do driver de miniclasse.

ExtensionInit inicializa a extensão de minitape e o driver de miniclasse usa essa área para manter o estado de tempo de execução para seu dispositivo. O driver de classe de fita passa InquiryData e um ModeCapabilitiesPage para essa rotina porque essas estruturas contêm informações que um driver de miniclasse de fita pode querer armazenar na extensão de minitape.