Функция TapeClassInitialize (minitape.h)
Подпрограмма TapeClassInitialize выполняет большую часть инициализации драйвера и устройства от имени миникласса драйвера. TapeClassInitialize загружает точки входа драйвера ленты для запросов ленточных операций ввода-вывода в структуру данных драйвера miniclass, находит и утверждает неисключенные ленточные устройства, поддерживаемые драйвером миникласса, и выделяет и инициализирует ресурсы операционной системы для драйвера миникласса и его устройств. TapeClassInitialize использует сведения, относящиеся к миниклассу, предоставленные в TapeInitData и вызовы драйвера миникласса ленты для операций, относящихся к драйверам для конкретного драйвера.
Синтаксис
SCSIPORT_API ULONG TapeClassInitialize(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] PTAPE_INIT_DATA_EX TapeInitData
);
Параметры
[in] Argument1
Указатель на сведения о контексте драйвера, переданные в подпрограмму драйвера miniclass ленты DriverEnt ry. Формат информации зависит от операционной системы и не должен интерпретироваться драйвером миникласса ленты.
[in] Argument2
Указатель на вторую структуру контекста драйвера, переданную в подпрограмму драйвера miniclass ленты DriverEntry. Формат информации зависит от операционной системы и не должен интерпретироваться драйвером миникласса ленты.
[in] TapeInitData
Указатель на структуру TAPE_INIT_DATA_EX, содержащую сведения о драйвере, такие как точки входа для подпрограмм обработки команд драйвера ленточного миникласса.
Возвращаемое значение
TapeClassInitialize возвращает значение, указывающее на успешность или сбой инициализации драйвера. Драйвер миникласса ленты передает это значение, не интерпретированный, как возвращаемое значение из подпрограммы DriverEntry.
Замечания
Драйвер миникласса ленты вызывает TapeClassInitialize из подпрограммы driverEntry DriverEntry и передает сведения о драйвере в TapeInitData. TapeClassInitialize выполняет большую часть инициализации драйвера от имени драйвера miniclass и изолирует драйвер миникласса от сведений о операционной системе.
TapeClassInitialize вызывает драйвер миникласса ленты для действий, необходимых для действий, необходимых для инициализации. Например, TapeClassInitialize вызывает подпрограмму ленты miniclass драйвера TapeMiniVerifyInquiry, чтобы определить, поддерживает ли драйвер заданное ленточное устройство. TapeClassInitialize также вызывает подпрограмму ленты miniclass драйвера TapeMiniExtensionInit для инициализации расширения минитапе, если драйвер миникласса запрашивал один.
Драйвер миникласса ленты выделяет структуру TAPE_INIT_DATA_EX на стеке, очищает ее с помощью TapeClassZeroMemory, заполняет все соответствующие элементы и передает его в TapeClassInitialize.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | minitape.h (include Minitape.h) |
| библиотеки | Tape.lib |