Fonction UrsIoResourceListAppendDescriptor (ursdevice.h)
Ajoute le descripteur de ressources spécifié à l’objet de liste de ressources d’E/S spécifié qui gère les descripteurs de ressources pour l’hôte ou le rôle de fonction.
Syntaxe
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Paramètres
[in] IoResourceList
Objet de liste de ressources d’E/S d’un rôle auquel le descripteur de ressource est ajouté. Cet objet est alloué par l’infrastructure et transmis au pilote client lorsque l’infrastructure appelle l’implémentation EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS du pilote.
[in] Descriptor
Pointeur vers IO_RESOURCE_DESCRIPTOR qui contient le descripteur de ressources pour le rôle.
Valeur retournée
La méthode retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner un code d’erreur NTSTATUS approprié.
Remarques
Une fois que le pilote client a appelé UrsDeviceInitialize, l’infrastructure alloue de la mémoire pour la liste des besoins en ressources. Lorsque l’extension de classe à double rôle USB appelle l’implémentation du pilote client de EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS, elle transmet un handle WDFIORESREQLIST à cette liste de conditions requises, ainsi que des handles URSIORESLIST pour les listes de ressources de rôle d’hôte et de fonction. Dans l’implémentation, le pilote client est censé énumérer dans la liste des exigences et ajouter le descripteur de ressource (s’il souhaite utiliser cette ressource) à la liste de ressources pour chaque rôle.
Pour ajouter un descripteur de ressource pour un rôle, le pilote appelle UrsIoResourceListAppendDescriptor et spécifie le descripteur et la liste de ressources auxquels la ressource doit être ajoutée.
Pour obtenir un exemple de code, consultez EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.
Pour plus d’informations sur les listes de ressources requises, consultez Gestion des ressources matérielles.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Windows |
| Version KMDF minimale | 1.15 |
| En-tête | ursdevice.h (include Urscx.h) |
| Bibliothèque | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |