WdfUsbTargetDeviceGetDeviceDescriptor, fonction (wdfusb.h)
[S’applique à KMDF et UMDF]
La méthode WdfUsbTargetDeviceGetDeviceDescriptor récupère le descripteur de périphérique USB pour le périphérique USB associé à un objet de périphérique USB d’infrastructure spécifié.
Syntaxe
void WdfUsbTargetDeviceGetDeviceDescriptor(
[in] WDFUSBDEVICE UsbDevice,
[out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);
Paramètres
[in] UsbDevice
Handle pour un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.
[out] UsbDeviceDescriptor
Pointeur vers une structure de USB_DEVICE_DESCRIPTOR allouée à l’appelant qui reçoit le descripteur de périphérique USB.
Valeur de retour
None
Remarques
Un bogue case activée se produit si un handle d’objet fourni par le pilote n’est pas valide.
Pour plus d’informations sur la méthode WdfUsbTargetDeviceGetDeviceDescriptor et les cibles d’E/S USB, consultez Cibles d’E/S USB.
Exemples
L’exemple de code suivant obtient le descripteur de périphérique USB pour un appareil. L’exemple stocke le descripteur dans l’espace de contexte défini par le pilote.
PMY_DEVICE_CONTEXT myDeviceContext;
myDeviceContext = GetDeviceContext(device);
WdfUsbTargetDeviceGetDeviceDescriptor(
myDeviceContext->UsbTargetDevice,
&myDeviceContext->UsbDeviceDescr
);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfusb.h (inclure Wdfusb.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |