IWDFUsbTargetDevice ::RetrieveUsbInterface, méthode (wudfusb.h)

[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]

La méthode RetrieveUsbInterface récupère l’interface USB spécifiée pour un périphérique USB.

Syntaxe

HRESULT RetrieveUsbInterface(
  [in]  UCHAR            InterfaceIndex,
  [out] IWDFUsbInterface **ppUsbInterface
);

Paramètres

[in] InterfaceIndex

Index de l’interface à récupérer.

[out] ppUsbInterface

Pointeur vers une variable qui reçoit un pointeur vers le IWDFUsbInterface spécifié interface pour le périphérique USB.

Valeur de retour

RetrieveUsbInterface retourne l’une des valeurs suivantes :

Remarques

Le pilote peut appeler la méthode IWDFUsbTargetDevice ::GetNumInterfaces pour récupérer le nombre total d’interfaces USB disponibles.

Le pilote peut utiliser le pointeur d’interface qui RetrieveUsbInterface récupère, pour appeler les méthodes que fournit l’interface IWDFUsbInterface. Pour plus d’informations sur l’utilisation de ces méthodes, consultez Utilisation des interfaces USB dans UMDF.

Exemples

Pour obtenir un exemple de code montrant comment utiliser la méthode RetrieveUsbInterface, consultez IWDFUsbTargetFactory ::CreateUsbTargetDevice.

Exigences

Voir aussi

IWDFUsbInterface

IWDFUsbTargetDevice

IWDFUsbTargetDevice ::GetNumInterfaces

USBD_INTERFACE_INFORMATION