UrsIoResourceListAppendDescriptor, fonction (ursdevice.h)
Ajoute le descripteur de ressource 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 ressource pour le rôle.
Valeur de retour
La méthode retourne STATUS_SUCCESS si l’opération réussit. Dans le cas contraire, cette méthode peut retourner un code d’erreur NTSTATUS approprié .
Remarques
Une fois que le pilote client appelle UrsDeviceInitialize, l’infrastructure alloue de la mémoire pour la liste des exigences de 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 les handles URSIORESLIST pour les listes de ressources hôtes et de rôle de fonction listes de ressources. Dans l’implémentation, le pilote client est censé énumérer par le biais de la liste des exigences et ajouter le descripteur de ressource (s’il souhaite utiliser cette ressource) à la liste des ressources pour chaque rôle.
Pour ajouter des descripteurs de ressources pour un rôle, le pilote appelle UrsIoResourceListAppendDescriptor et spécifie le descripteur et la liste des ressources auxquelles 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 configuration requise pour les ressources, consultez Gestion des ressources matérielles.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| version minimale de KMDF | 1.15 |
| d’en-tête | ursdevice.h (include Urscx.h) |
| bibliothèque | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |