UdecxUsbDeviceInitSetEndpointsType-Funktion (udecxusbdevice.h)

Artikel
08/07/2023

Gibt den Typ des Endpunkts (einfach oder dynamisch) in den Initialisierungsparametern an, den 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 UdecxUsbDeviceInitAllocate abgerufen.

[in] UdecxEndpointType

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

Rückgabewert

Keine

Bemerkungen

Vor dem Erstellen des virtuellen USB-Geräts muss der Clienttreiber den Typ des unterstützten Endpunkts angeben. Es kann einen von zwei Typen unterstützen (die in UDECX_ENDPOINT_TYPE definiert sind):

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

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 UdecxUsbDeviceInitSetStateChangeCallbacks festgelegt haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
KMDF-Mindestversion	1.15
Kopfzeile	udecxusbdevice.h (include Udecx.h)
Bibliothek	Udecxstub.lib
IRQL	PASSIVE_LEVEL