UdecxUsbDeviceInitSetEndpointsType-Funktion (udecxusbdevice.h)

Artikel
02/07/2025

Gibt den Endpunkttyp (einfach oder dynamisch) in den Initialisierungsparametern an, die der Clienttreiber zum Erstellen des virtuellen USB-Geräts verwendet.

Syntax

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

Parameter

[in, out] UdecxUsbDeviceInit

Ein Zeiger auf eine WDF-zugeordnete Struktur, die Initialisierungsparameter für das virtuelle USB-Gerät enthält. Der Clienttreiber hat diesen Zeiger im vorherigen Aufruf von UdecxUsbDeviceInitAllocateabgerufen.

[in] UdecxEndpointType

Ein UDECX_ENDPOINT_TYPE-type-Wert, der den Typ des USB-Endpunkts angibt.

Rückgabewert

Nichts

Bemerkungen

Bevor Sie das virtuelle USB-Gerät erstellen, muss der Clienttreiber den Unterstützten Endpunkttyp angeben. Sie kann einen von zwei Typen unterstützen (definiert in UDECX_ENDPOINT_TYPE):

Einfacher Endpunkt: Der Clienttreiber erstellt alle Endpunktobjekte, bevor das Gerät eingesteckt wird. Das Gerät darf nur eine Konfiguration und eine Schnittstelleneinstellung pro Schnittstelle aufweisen.
Dynamischer Endpunkt: Der Client erstellt Endpunktobjekte in der EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE Rückruffunktion. Die ERWEITERUNG der USB-Geräteemulationsklasse (UdeCx) ruft die Implementierung des Treibers auf, wenn sie eine Anforderung zum Hinzufügen oder Konfigurieren von Endpunkten abruft.

Die UdecxUsbDeviceInit ist eine undurchsichtige Struktur, die Zeiger auf Rückruffunktionen im Zusammenhang mit Endpunkten enthält. Wenn der Clienttreiber dynamische Endpunkte unterstützt, müssen diese Rückruffunktionen vom Treiber implementiert werden:

Vor dem Aufrufen dieser Methode muss der Clienttreiber diese Zeiger durch Aufrufen von UdecxUsbDeviceInitSetStateChangeCallbacksfestgelegt haben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Minimale KMDF-Version	1.15
Header-	udecxusbdevice.h (include Udecx.h)
Library	Udecxstub.lib
IRQL-	PASSIVE_LEVEL