EVT_UDECX_USB_DEVICE_ENDPOINT_ADD Rückruffunktion (udecxusbdevice.h)

Die USB-Geräteemulationsklassenerweiterung (UdeCx) ruft diese Rückruffunktion auf, um den Clienttreiber anzufordern, einen dynamischen Endpunkt auf dem virtuellen USB-Gerät zu erstellen.

Syntax

EVT_UDECX_USB_DEVICE_ENDPOINT_ADD EvtUdecxUsbDeviceEndpointAdd;

NTSTATUS EvtUdecxUsbDeviceEndpointAdd(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] PUDECX_USB_ENDPOINT_INIT_AND_METADATA EndpointToCreate
)
{...}

Parameter

[in] UdecxUsbDevice

Ein Handle für das UDE-Geräteobjekt, für das der Clienttreiber einen Endpunkt erstellt. Der Treiber hat dieses Objekt in einem vorherigen Aufruf von UdecxUsbDeviceCreate erstellt.

[in] EndpointToCreate

Ein Zeiger auf eine UDECX_USB_ENDPOINT_INIT_AND_METADATA-Struktur , die den Endpunktdeskriptor enthält.

Rückgabewert

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist.

Hinweise

Der Clienttreiber hat diese Rückruffunktion in einem vorherigen Aufruf von UdecxUsbDeviceInitSetStateChangeCallbacks registriert, indem er einen Funktionszeiger auf seine Implementierung angibt.

In der Implementierung wird erwartet, dass der Clienttreiber den Endpunkt durch Aufrufen von UdecxUsbEndpointCreate mithilfe der Initialisierungsparameter (UDECXUSBENDPOINT_INIT) erstellt, die von der Klassenerweiterung in der UDECX_USB_ENDPOINT_INIT_AND_METADATA-Struktur übergeben werden.

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)
IRQL PASSIVE_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

UdecxUsbEndpointErstellen

Schreiben eines UDE-Clienttreibers