WdfUsbInterfaceGetEndpointInformation, fonction (wdfusb.h)

[S’applique à KMDF et UMDF]

La méthode WdfUsbInterfaceGetEndpointInformation récupère des informations sur un point de terminaison d’appareil USB spécifié et son canal associé.

Syntaxe

VOID WdfUsbInterfaceGetEndpointInformation(
  [in]      WDFUSBINTERFACE           UsbInterface,
  [in]      UCHAR                     SettingIndex,
  [in]      UCHAR                     EndpointIndex,
  [in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);

Paramètres

[in] UsbInterface

Handle vers un objet d’interface USB obtenu en appelant WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Valeur d’index qui identifie un autre paramètre pour l’interface. Pour plus d’informations sur les autres paramètres, consultez la spécification USB.

[in] EndpointIndex

Valeur d’index qui identifie un point de terminaison associé au paramètre secondaire spécifié de l’interface spécifiée. (Cette valeur d’index n’est pas l’adresse du point de terminaison.)

[in, out] EndpointInfo

Pointeur vers une structure WDF_USB_PIPE_INFORMATION allouée par l’appelant que l’infrastructure remplit.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

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

Exemples

L’exemple de code suivant obtient le nombre de points de terminaison pris en charge par une interface USB, puis appelle WdfUsbInterfaceGetEndpointInformation pour chaque point de terminaison.

WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;

settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                          UsbInterface,
                                          settingIndex
                                          );

for (i = 0; i < numEndpoints; i++){
    WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
    WdfUsbInterfaceGetEndpointInformation(
                                          UsbInterface,
                                          settingIndex,
                                          i,
                                          &endPointInfo
                                          );

    //
    // Examine endpoint information here.
    //
...
}

Exigences

Voir aussi

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface