Функция TapeClassInitialize (minitape.h)

Статья
08/07/2023

Подпрограмма TapeClassInitialize выполняет большую часть инициализации драйвера и устройства от имени драйвера мини-класса. TapeClassInitialize загружает точки входа драйвера класса ленты для ленточных запросов ввода-вывода в структуру данных драйвера миникласса, находит и утверждает невостребованные ленточные устройства, поддерживаемые драйвером мини-класса, а также выделяет и инициализирует ресурсы операционной системы для драйвера мини-класса и его устройств. TapeClassInitialize использует сведения, относящиеся к драйверу миникласса, поставляемые в TapeInitData , и вызывает драйвер ленточного миникласса для выполнения операций с конкретными драйверами.

Синтаксис

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

Параметры

[in] Argument1

Указатель на сведения о контексте драйвера, переданные в подпрограмму DriverEntry драйвера на ленте миникласса. Формат сведений зависит от операционной системы и не должен интерпретироваться драйвером мини-класса ленты.

[in] Argument2

Указатель на структуру контекста второго драйвера, переданную в подпрограмму DriverEntry драйвера ленты миникласса. Формат сведений зависит от операционной системы и не должен интерпретироваться драйвером мини-класса ленты.

[in] TapeInitData

Указатель на структуру TAPE_INIT_DATA_EX, содержащую сведения, относящиеся к драйверу, например точки входа для процедур обработки команд драйвера мини-класса ленты.

Возвращаемое значение

TapeClassInitialize возвращает значение, указывающее на успешное или неудачное завершение инициализации драйвера. Драйвер мини-класса ленты передает это значение без интерпретированного в качестве значения, возвращаемого из своей подпрограммы DriverEntry .

Драйвер миникласса ленты вызывает TapeClassInitialize из своей подпрограммы DriverEntry и передает сведения о конкретном драйвере в TapeInitData. TapeClassInitialize выполняет большую часть инициализации драйвера от имени драйвера мини-класса и изолирует драйвер мини-класса от сведений, относящихся к операционной системе.

TapeClassInitialize вызывает драйвер мини-класса ленты для действий, относящихся к конкретному драйверу, необходимых во время инициализации. Например, TapeClassInitialize вызывает подпрограмму TapeMiniVerifyInquiry драйвера ленты миникласса, чтобы определить, поддерживает ли драйвер данное ленточное устройство. TapeClassInitialize также вызывает подпрограмму TapeMiniExtensionInit драйвера ленты для инициализации расширения minitape, если драйвер миникласса запросил его.

Драйвер ленточного мини-класса выделяет структуру TAPE_INIT_DATA_EX в стеке, очищает ее с помощью TapeClassZeroMemory, заполняет все соответствующие элементы и передает ее в TapeClassInitialize.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	minitape.h (включая Minitape.h)
Библиотека	Tape.lib

См. также раздел

DriverEntry of Tape Miniclass Driver

TAPE_INIT_DATA_EX

Share via