Fonction WdfUsbInterfaceGetEndpointInformation (wdfusb.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La méthode WdfUsbInterfaceGetEndpointInformation récupère des informations sur un point de terminaison de périphérique 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 pour 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 alternatif 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 de WDF_USB_PIPE_INFORMATION allouée par l’appelant que l’infrastructure remplit.

Valeur de retour

None

Remarques

Un bogue case activée 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.
    //
...
}

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	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Voir aussi

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface

Partager via