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

另请参阅

磁带微型类驱动程序的 DriverEntry

TAPE_INIT_DATA_EX