SRB_OPEN_DEVICE_INSTANCE
Le pilote de classe envoie cette demande pour ouvrir une instance de l’adaptateur.
Valeur de retour
Le minidriver doit définir l’un des éléments suivants comme status dans le SRB :
STATUS_SUCCESS
Indique la réussite de la commande.
STATUS_NOT_IMPLEMENTED
Indique que la fonction n’est pas prise en charge par le minidriver.
STATUS_TOO_MANY_NODES
Indique qu’il n’y a pas suffisamment de ressources pour ouvrir ce flux.
STATUS_IO_DEVICE_ERROR
Indique qu’une défaillance matérielle s’est produite.
Commentaires
Si le minidriver prend en charge plusieurs instances d’un appareil, cette commande est envoyée par le pilote de classe chaque fois qu’une nouvelle instance de l’adaptateur est ouverte. Par exemple, considérez un décodeur DSP qui peut allouer n nombre d’instances des flux spécifiés. Le champ HwInstanceExtension dans le SRB doit alors être défini sur l’espace de travail par instance du minidriver par le pilote de classe.
La plupart des adaptateurs ne prennent pas en charge plusieurs instances. Dans ces cas, le champ FilterInstanceExtensionSize de la structure HW_INITIALIZATION_DATA doit être défini sur zéro et ne doit jamais recevoir cette commande.