WdfUsbTargetDeviceGetDeviceDescriptor, fonction (wdfusb.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfUsbTargetDeviceGetDeviceDescriptor récupère le descripteur d’appareil USB pour le périphérique USB associé à un objet d’appareil USB de framework spécifié.

Syntaxe

void WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

Paramètres

[in] UsbDevice

Handle vers un objet de périphérique USB obtenu à partir d’un appel précédent à WdfUsbTargetDeviceCreateWithParameters.

[out] UsbDeviceDescriptor

Pointeur vers une structure USB_DEVICE_DESCRIPTOR allouée par l’appelant qui reçoit le descripteur d’appareil USB.

Valeur de retour

Aucun

Remarques

Une vérification des bogues 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 d’appareil 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
                                      );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfusb.h (include 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)

Voir aussi

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters

Partager via