WdfUsbTargetDeviceWdmGetConfigurationHandle, fonction (wdfusb.h)

  • Article

[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)

Voir aussi

URB

WdfUsbTargetDeviceSelectConfig

_URB_SELECT_INTERFACE