TAPE_EXTENSION_INIT_ROUTINE回调函数 (minitape.h)

项目
02/26/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 。

返回值

无

备注

磁带微型类驱动程序通过在从 DriverEntry 例程传递给 TapeClassInitialize 的 TAPE_INIT_DATA_EX 结构中指定 MinitapeExtensionSize 的非零值来请求 minitape 扩展。微类驱动程序定义微型磁带扩展的结构和内容，并通常使用它来存储它所支持设备的查询数据。

磁带类驱动程序分配微型磁带扩展，并在随后调用处理设备控制请求的设备特定方面的磁带微类驱动程序例程和微类驱动程序的可选 TapeMiniTapeError 例程时提供该扩展。

ExtensionInit 初始化微型任务扩展，微型类驱动程序使用此区域来维护其设备的运行时状态。磁带类驱动程序将 InquiryData 和 ModeCapabilitiesPage 传递给此例程，因为这些结构包含磁带微型类驱动程序可能希望存储在微型磁带扩展中的信息。