WdfUsbTargetDeviceWdmGetConfigurationHandle, fonction (wdfusb.h)
[S’applique uniquement à KMDF]
La méthode WdfUsbTargetDeviceWdmGetConfigurationHandle retourne le handle de type USBD_CONFIGURATION_HANDLE associé à la configuration actuelle d’un périphérique USB spécifié.
Syntaxe
USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
[in] WDFUSBDEVICE UsbDevice
);
Paramètres
[in] UsbDevice
Handle pour un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.
Valeur retournée
Si le pilote a sélectionné une configuration pour l’appareil, WdfUsbTargetDeviceWdmGetConfigurationHandle retourne le handle de type USBD_CONFIGURATION_HANDLE de l’appareil. Sinon, la méthode retourne NULL.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Un pilote basé sur l’infrastructure doit obtenir un handle de type USBD_CONFIGURATION_HANDLE uniquement s’il crée un URB qui contient une structure _URB_SELECT_INTERFACE .
Le pilote peut appeler WdfUsbTargetDeviceWdmGetConfigurationHandle après avoir appelé WdfUsbTargetDeviceSelectConfig. Le handle de type USBD_CONFIGURATION_HANDLE que WdfUsbTargetDeviceWdmGetConfigurationHandle retourne est valide jusqu’à ce que le pilote appelle À nouveau WdfUsbTargetDeviceSelectConfig ou que l’objet de périphérique USB soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de périphérique USB et si l’objet est supprimé avant que le pilote n’appelle à nouveau WdfUsbTargetDeviceSelectConfig , le handle est valide jusqu’à ce que la fonction EvtCleanupCallback de l’objet soit retournée.
Pour plus d’informations sur la méthode WdfUsbTargetDeviceWdmGetConfigurationHandle et les cibles d’E/S USB, consultez Cibles d’E/S USB.
Exemples
L’exemple de code suivant obtient un handle pour la configuration actuelle d’un périphérique USB spécifié.
USBD_CONFIGURATION_HANDLE deviceConfigHdl;
deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfusb.h (inclure Wdfusb.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |