StreamClassRegisterAdapter 函数 (strmini.h)
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 对微型驱动程序的 StrMiniReceiveDevicePacket 例程(作为 HwReceivePacket 成员的 HW_INITIALIZATION_DATA 成员传递)查询微型驱动程序以获取其他启动信息。
注册后,微型驱动程序可以驱动系统中的任意数量的适配器实例。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | strmini.h (包括 Strmini.h) |