UdecxUsbDeviceInitSetEndpointsType, fonction (udecxusbdevice.h)

Article
02/26/2024

Indique le type de point de terminaison (simple ou dynamique) dans les paramètres d’initialisation que le pilote client utilise 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 lors de l’appel précédent à UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

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

Valeur de retour

None

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 seul 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’elle obtient une demande d’ajout ou de configuration de points de terminaison.

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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
Version KMDF minimale	1.15
En-tête	udecxusbdevice.h (include Udecx.h)
Bibliothèque	Udecxstub.lib
IRQL	PASSIVE_LEVEL