UcxEndpointCreate, fonction (ucxendpoint.h)

Article
02/26/2024

Crée un point de terminaison sur l’objet périphérique USB spécifié.

Syntaxe

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

Paramètres

[in] UsbDevice

Handle de l’objet de périphérique USB qui contient le point de terminaison. Le pilote client a récupéré le handle dans un appel précédent à UcxUsbDeviceCreate.

[out] EndpointInit

Pointeur vers une structure de UCXENDPOINT_INIT qui décrit diverses opérations de configuration pour la création de l’objet de point de terminaison. Le pilote spécifie des pointeurs de fonction vers ses fonctions de rappel dans cette structure. Cette structure est gérée par UCX.

[in, optional] Attributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui spécifie des attributs pour l’objet de point de terminaison.

[out] Endpoint

Pointeur vers une variable qui reçoit un handle vers le nouvel objet de point de terminaison.

Valeur retournée

La méthode retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Le pilote client du contrôleur hôte doit appeler cette méthode après l’appel WdfDeviceCreate . Le parent du nouvel objet de point de terminaison est l’objet périphérique USB.

La méthode initialise l’objet de point de terminaison avec des informations telles que le type de point de terminaison, le canal, le transfert et la taille maximale des transferts.

Pour obtenir un exemple de code, consultez EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Plateforme cible	Windows
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	ucxendpoint.h (inclure Ucxclass.h, Ucxendpoint.h)
IRQL	PASSIVE_LEVEL

Partager via