UcxEndpointCreate, fonction (ucxendpoint.h)

Crée un point de terminaison sur l’objet de 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 vers l’objet 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 pour UcxUsbDeviceCreate.

[out] EndpointInit

Pointeur vers une structure UCXENDPOINT_INIT qui décrit différentes opérations de configuration pour la création de l’objet de point de terminaison. Le pilote spécifie les 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 WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui spécifie les attributs de 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 de retour

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

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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
plateforme cible	Windows
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL	PASSIVE_LEVEL