WdfUsbTargetDeviceGetInterface, fonction (wdfusb.h)

[S’applique à KMDF et UMDF]

La méthode WdfUsbTargetDeviceGetInterface retourne un handle à l’objet d’interface USB framework associé à un index d’interface spécifié.

Syntaxe

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Paramètres

[in] UsbDevice

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

[in] InterfaceIndex

Valeur d’index de base zéro qui spécifie un objet d’interface USB dans la configuration actuelle. Cette valeur d’index peut ne pas être identique au numéro d’interface défini par la spécification USB.

Valeur de retour

WdfUsbTargetDeviceGetInterface retourne un handle à un objet d’interface USB. Si la valeur InterfaceIndex n’est pas valide, cette méthode retourne NULL.

Une vérification des bogues se produit si un handle d’objet fourni par le pilote n’est pas valide.

Remarques

Pour plus d’informations sur la méthode WdfUsbTargetDeviceGetInterface et les cibles d’E/S USB, consultez cibles d’E/S USB.

Exemples

L’exemple de code suivant obtient un handle pour le premier objet d’interface USB que l’infrastructure a créé pour un périphérique USB. L’exemple obtient ensuite le nombre de points de terminaison associés à l’objet d’interface.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

Exigences

Voir aussi

WdfUsbTargetDeviceCreateWithParameters