StreamClassRegisterAdapter 函数 (strmini.h)

项目
03/05/2024

StreamClassRegisterAdapter 例程注册流类微型驱动程序。

仅出于向后兼容性，支持名称 StreamClassRegisterAdapter 。

相反，Microsoft 建议使用 StreamClassRegisterMinidriver（ StreamClassRegisterAdapter 的别名）。 名称 StreamClassRegisterMinidriver 更准确地指示例程注册流类微型驱动程序。注册后，微型驱动程序可以在系统中驱动任意数量的适配器实例。

StreamClassRegisterMinidriver 例程向流类驱动程序注册流微型驱动程序。

语法

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

参数

[in] Argument1

指向微型驱动程序的 DriverEntry 例程的第一个参数。

[in] Argument2

指向微型驱动程序 DriverEntry 例程的第二个参数。

[in] HwInitializationData

指向 HW_INITIALIZATION_DATA 结构，该结构提供类驱动程序开始初始化微型驱动程序所需的信息。

返回值

在成功时返回STATUS_SUCCESS，或在失败时返回相应的错误代码。

注解

流微型驱动程序必须在其 DriverEntry 例程中调用 StreamClassRegisterMinidriver。

流微型驱动程序的 DriverEntry 初始化流类微型驱动程序。此例程是必需的。

Argument1 提供适配器微型驱动程序应用来调用 StreamClassRegisterMinidriver 的上下文值。对于 Windows 2000 及更高版本，这指向DRIVER_OBJECT。

Argument2 提供适配器微型驱动程序应用来调用 StreamClassRegisterMinidriver 的第二个上下文值。对于 Windows 2000 及更高版本，这指向注册表路径。

DriverEntry 返回其调用 StreamClassRegisterMinidriver 所返回的值。

备注 DriverEntry 是流类微型驱动程序的初始入口点。

由于 StreamClassRegisterMinidriver 执行大部分必需的驱动程序初始化，因此流类微型驱动程序的 DriverEntry 例程的主要任务是使用特定于驱动程序的常量和入口点分配和填充HW_INITIALIZATION_DATA结构。然后，DriverEntry 应调用 StreamClassRegisterMinidriver。

HW_INITIALIZATION_DATA 结构中传递的大多数信息都会通知类驱动程序微型驱动程序范围的回调，以及要为微型驱动程序的数据结构分配的大小缓冲区。类驱动程序通过SRB_INITIALIZE_DEVICE查询微型驱动程序的其他启动信息，并SRB_GET_STREAM_INFO请求作为HW_INITIALIZATION_DATA) 的 HwReceivePacket 成员传递的微型驱动程序的 StrMiniReceiveDevicePacket 例程 (。

注册后，微型驱动程序可以在系统中驱动任意数量的适配器实例。