TapeClassInitialize 函数 (minitape.h)
TapeClassInitialize 例程代表微型类驱动程序执行大部分驱动程序和设备初始化。 TapeClassInitialize 将磁带 I/O 请求的磁带类驱动程序入口点加载到微类驱动程序数据结构中,查找并声明微型类驱动程序支持的无人认领的磁带设备,并为微类驱动程序及其设备分配和初始化操作系统资源。 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 例程的返回值传递。
注解
磁带微型类驱动程序从其 DriverEntry 例程调用 TapeClassInitialize,并在 TapeInitData 中传递特定于驱动程序的信息。 TapeClassInitialize 代表微型类驱动程序执行大部分驱动程序初始化,并将微类驱动程序与特定于操作系统的详细信息隔离开来。
TapeClassInitialize 为初始化期间所需的特定于驱动程序的活动调用磁带微类驱动程序。 例如, TapeClassInitialize 调用磁带小类驱动程序的 TapeMiniVerifyInquiry 例程来确定驱动程序是否支持给定的磁带设备。 TapeClassInitialize 还会调用磁带微类驱动程序的 TapeMiniExtensionInit 例程来初始化微类扩展(如果微类驱动程序请求扩展)。
磁带微型类驱动程序在堆栈上分配TAPE_INIT_DATA_EX结构,使用 TapeClassZeroMemory 将其清除,填充所有适当的成员,并将其传递给 TapeClassInitialize。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | minitape.h (包括 Minitape.h) |
Library | Tape.lib |