WdfUsbTargetDeviceGetDeviceDescriptor, fonction (wdfusb.h)

Article
08/08/2023

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

Voir aussi

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters

Partager via