Compartilhar via


SRB_OPEN_DEVICE_INSTANCE

O driver de classe envia essa solicitação para abrir uma instância do adaptador.

Valor retornado

O minidriver deve definir um dos seguintes como o status no SRB:

STATUS_SUCCESS
Indica a conclusão bem-sucedida do comando.

STATUS_NOT_IMPLEMENTED
Indica que a função não é compatível com o minidriver.

STATUS_TOO_MANY_NODES
Indica que não há recursos suficientes para abrir esse fluxo.

STATUS_IO_DEVICE_ERROR
Indica que ocorreu uma falha de hardware.

Comentários

Se o minidriver der suporte a várias instâncias de um dispositivo, esse comando será enviado pelo driver de classe sempre que uma nova instância do adaptador for aberta. Por exemplo, considere um decodificador DSP que pode alocar n número de instâncias dos fluxos especificados. O campo HwInstanceExtension no SRB deve ser definido como o workspace por instância do minidriver pelo driver de classe.

A maioria dos adaptadores não dá suporte a várias instâncias, portanto, nesses casos, o campo FilterInstanceExtensionSize na estrutura HW_INITIALIZATION_DATA deve ser definido como zero e nunca deve receber esse comando.

Confira também

SRB_CLOSE_DEVICE_INSTANCE