SRB_OPEN_DEVICE_INSTANCE

类驱动程序发送此请求以打开适配器的实例。

返回值

微型驱动程序应在 SRB 中将以下项之一设置为状态:

STATUS_SUCCESS
指示命令成功完成。

STATUS_NOT_IMPLEMENTED
指示微型驱动程序不支持该函数。

STATUS_TOO_MANY_NODES
指示没有足够的资源打开此流。

STATUS_IO_DEVICE_ERROR
指示发生硬件故障。

注释

如果微型驱动程序支持设备的多个实例,则每次打开适配器的新实例时,类驱动程序将发送此命令。 例如,假设有一个可以分配 n 个指定 流的实例数的编码解码器。 然后,类驱动程序应将 SRB 中的 HwInstanceExtension 字段设置为微型驱动程序的按实例工作区。

大多数适配器不支持多个实例,因此在这种情况下,HW_INITIALIZATION_DATA 结构中的 FilterInstanceExtensionSize字段应 设置为零,并且不应收到此命令。

另请参阅

SRB_CLOSE_DEVICE_INSTANCE