функция обратного вызова TAPE_EXTENSION_INIT_ROUTINE (minitape.h)

2025-02-07

ExtensionInit инициализирует необязательную область контекста для конкретного драйвера. Эта подпрограмма вызывается TapeClassInitialize при загрузке драйвера миникласса ленты. Эта подпрограмма является необязательной.

Синтаксис

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

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

Параметры

[in] MinitapeExtension

Указатель на буфер размера, запрошенного драйвером миникласса ленты при инициализации.

[in] InquiryData

Указатель на данные запроса SCSI для ленточного устройства.

[in] ModeCapabilitiesPage

Указатель на буфер, содержащий сведения низкого уровня для ленточного устройства. Формат этой страницы определяется стандартом QIC 157 и подлежит изменению. Это значение NULL, если устройство не поддерживает страницу возможностей режима.

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

Никакой

Замечания

Драйвер миникласса ленты запрашивает расширение minitape путем указания ненулевого значения для MinitapeExtensionSizeSize в структуре TAPE_INIT_DATA_EX передается в TapeClassInitialize из подпрограммы DriverEntry. Драйвер миникласса определяет структуру и содержимое расширения minitape и обычно использует его для хранения данных запроса для поддерживаемых устройств.

Драйвер класса ленты выделяет расширение minitape и предоставляет его впоследствии в вызовах подпрограмм драйвера ленточного миникласса, обрабатывающих аспекты запросов управления устройствами и необязательный TapeMiniTapeError подпрограммы драйвера miniclass.

ExtensionInit инициализирует расширение minitape, а драйвер miniclass использует эту область для поддержания состояния времени выполнения для своего устройства. Драйвер класса ленты передает InquiryData и ModeCapabilitiesPagePage, так как эти структуры содержат сведения о том, что драйвер миникласса ленты может потребоваться сохранить в расширении minitape.