estrutura TAPE_INIT_DATA_EX (minitape.h)

Artigo
03/08/2023

TAPE_INIT_DATA_EX define valores e rotinas específicos para um driver de miniclasse de fita do Windows 2000. A rotina DriverEntry de miniclasse de fita passa essas informações para o driver de classe de fita para concluir a inicialização do driver de miniclasse.

Sintaxe

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;

Membros

InitDataSize

Tamanho dessa estrutura, em bytes.

VerifyInquiry

Especifica o ponto de entrada da rotina TapeMiniVerifyInquiry do driver de miniclasse de fita, que determina se o driver dá suporte a um determinado dispositivo. Essa rotina é necessária.

QueryModeCapabilitiesPage

Direciona o driver de classe de fita quando TRUE passa uma página de funcionalidades de modo para as rotinas TapeMiniVerifyInquiry e TapeMiniExtensionInit do driver de miniclasse de fita.

MinitapeExtensionSize

Especifica o tamanho, em bytes, de uma área de contexto específica do driver. Se esse membro for diferente de zero, ExtensionInit não deverá ser NULL. Esse valor é opcional e deve ser definido como zero se não for usado.

ExtensionInit

Ponteiro para a rotina TapeMiniExtensionInit do driver de miniclasse de fita, que inicializa uma extensão de minitape opcional, se houver. Se MiniTapeExtensionSize for zero, ExtensionInit deverá ser NULL.

DefaultTimeOutValue

Especifica o número de segundos que o driver de classe de fita aguarda uma solicitação SRB antes de cancelá-la. Se esse valor for zero, o driver de classe de fita definirá um valor padrão apropriado. O driver de classe de fita sempre usa o valor de tempo limite padrão para solicitações de leitura e gravação. As rotinas contidas na estrutura TAPE_INIT_DATA_EX podem substituir o valor de tempo limite padrão para solicitações de controle de dispositivo definindo TimeOutValue em um SRB.

TapeError

Ponteiro para a rotina TapeMiniTapeError do driver de miniclasse de fita, que aumenta as atividades de tratamento de erros do driver de classe de fita. Essa rotina é opcional. Se um não for usado, TapeError deverá ser definido como NULL.

CommandExtensionSize

Especifica o tamanho, em bytes, de uma extensão de comando a ser alocada antes do início de cada comando de fita. Um driver de miniclasse de fita usa a extensão de comando para armazenar o contexto durante o processamento de comandos de fita. Seu tamanho e estrutura interna são definidos pelo driver de miniclasse de fita. Uma extensão de comando é opcional. Se um não for usado, CommandExtensionSize deverá ser definido como zero.

CreatePartition

Ponteiro para a rotina TapeMiniCreatePartition do driver de miniclasse de fita, que cria uma partição em uma fita. Essa rotina é necessária.

Erase

Ponteiro para a rotina TapeMiniErase do driver de miniclasse de fita, que apaga uma fita. Essa rotina é necessária.

GetDriveParameters

Ponteiro para a rotina TapeMiniGetDriveParameters do driver de miniclasse de fita, que manipula solicitações para obter parâmetros de unidade. Essa rotina é necessária.

GetMediaParameters

Ponteiro para a rotina TapeMiniGetMediaParameters do driver de miniclasse de fita, que manipula solicitações para obter parâmetros de mídia. Essa rotina é necessária.

GetPosition

Ponteiro para a rotina TapeMiniGetPosition do driver de miniclasse de fita, que manipula solicitações para obter a posição de uma fita. Essa rotina é necessária.

GetStatus

Ponteiro para a rotina TapeMiniGetStatus do driver de miniclasse de fita, que manipula solicitações de status. Essa rotina é necessária.

Prepare

Ponteiro para a rotina TapeMiniPrepare do driver de miniclasse de fita, que prepara um dispositivo de fita. Essa rotina é necessária.

SetDriveParameters

Ponteiro para a rotina TapeMiniSetDriveParameters do driver de miniclasse de fita, que define parâmetros de unidade. Essa rotina é necessária.

SetMediaParameters

Ponteiro para a rotina TapeMiniSetMediaParameters do driver de miniclasse de fita, que define parâmetros de mídia. Essa rotina é necessária.

SetPosition

Ponteiro para a rotina TapeMiniSetPosition do driver de miniclasse de fita, que posiciona uma fita. Essa rotina é necessária.

WriteMarks

Ponteiro para a rotina TapeMiniWriteMarks do driver de miniclasse de fita, que grava marcas em fita. Essa rotina é necessária.

PreProcessReadWrite

Ponteiro para a rotina TapeMiniPreProcessReadWrite do driver de miniclasse de fita, que executa operações específicas do dispositivo antes de todas as leituras e gravações. Essa rotina é opcional e não é necessária para a maioria dos drivers. Se um não for usado, PreProcessReadWrite deverá ser NULL.

TapeGetMediaTypes

Ponteiro para a rotina TapeMiniGetMediaTypes do driver de miniclasse de fita, que obtém uma descrição de cada tipo de mídia compatível com um dispositivo de fita. Essa rotina é necessária.

MediaTypesSupported

Indica o número de tipos de mídia compatíveis com o dispositivo.

TapeWMIOperations

Ponteiro para a rotina TapeMiniWMIControl .

Reserved[2]

Reservado.

Comentários

A rotina DriverEntry de um driver de miniclasse de fita chama TapeClassZeroMemory para limpar TAPE_INIT_DATA_EX, preenche os membros necessários e todos os membros opcionais apropriados e TapeClassInitialize com um ponteiro para essa estrutura.

Os nomes das rotinas de driver de miniclasse de fita indicados nas descrições de membro dessa estrutura são apenas nomes de espaço reservado. O protótipo dessas rotinas é declarado em newtape.h como TAPE_PROCESS_COMMAND_ROUTINE.

O significado dos parâmetros desse protótipo é diferente para cada rotina de driver de miniclasse. Para obter informações detalhadas sobre como esses parâmetros são usados, consulte as descrições para cada rotina de driver de miniclasse individual.