Fonction UrsIoResourceListAppendDescriptor (ursdevice.h)

  • Article

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

Voir aussi

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize