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

Статья
03/01/2024

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 , если устройство не поддерживает страницу возможностей режима.

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

None

Remarks

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

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

ExtensionInit инициализирует расширение мини-приложения, и драйвер мини-класса использует эту область для поддержания состояния времени выполнения для своего устройства. Драйвер класса ленты передает в эту подпрограмму ЗапросData и ModeCapabilitiesPage , так как эти структуры содержат сведения, которые драйверу мини-класса ленты может потребоваться сохранить в расширении мини-программы.