SRB_OPEN_DEVICE_INSTANCE

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

返回值

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

STATUS_SUCCESS
指示命令成功完成。

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

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

STATUS_IO_DEVICE_ERROR
指示发生了硬件故障。

注释

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

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

另请参阅

SRB_CLOSE_DEVICE_INSTANCE