UdecxUsbDeviceInitSetEndpointsType, fonction (udecxusbdevice.h)

Article
02/07/2025

Indique le type de point de terminaison (simple ou dynamique) dans les paramètres d’initialisation utilisés par le pilote client pour créer le périphérique USB virtuel.

Syntaxe

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Paramètres

[in, out] UdecxUsbDeviceInit

Pointeur vers une structure allouée par WDF qui contient des paramètres d’initialisation pour le périphérique USB virtuel. Le pilote client a récupéré ce pointeur dans l’appel précédent pour UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Valeur UDECX_ENDPOINT_TYPE-type qui indique le type de point de terminaison USB.

Valeur de retour

Aucun

Remarques

Avant de créer le périphérique USB virtuel, le pilote client doit indiquer le type de point de terminaison qu’il prend en charge. Il peut prendre en charge l’un des deux types (définis dans UDECX_ENDPOINT_TYPE) :

Point de terminaison simple : le pilote client crée tous les objets de point de terminaison avant de brancher l’appareil. L’appareil ne doit avoir qu’une seule configuration et un paramètre d’interface par interface.
Point de terminaison dynamique : le client crée des objets de point de terminaison dans la fonction de rappel EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE. L’extension de classe d’émulation de périphérique USB (UdeCx) appelle l’implémentation du pilote lorsqu’il obtient une demande d’ajout ou de configuration de points de terminaison.

Le UdecxUsbDeviceInit est une structure opaque qui contient des pointeurs vers des fonctions de rappel liées aux points de terminaison. Si le pilote client prend en charge les points de terminaison dynamiques, ces fonctions de rappel doivent être implémentées par le pilote :

Avant d’appeler cette méthode, le pilote client doit avoir défini ces pointeurs en appelant UdecxUsbDeviceInitSetStateChangeCallbacks.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
version minimale de KMDF	1.15
d’en-tête	udecxusbdevice.h (include Udecx.h)
bibliothèque	Udecxstub.lib
IRQL	PASSIVE_LEVEL