UcxEndpointCreate-Funktion (ucxendpoint.h)

Artikel
02/07/2025

Erstellt einen Endpunkt für das angegebene USB-Geräteobjekt.

Syntax

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

Parameter

[in] UsbDevice

Ein Handle für das USB-Geräteobjekt, das den Endpunkt enthält. Der Clienttreiber hat das Handle in einem vorherigen Aufruf von UcxUsbDeviceCreateabgerufen.

[out] EndpointInit

Ein Zeiger auf eine UCXENDPOINT_INIT-Struktur, die verschiedene Konfigurationsvorgänge zum Erstellen des Endpunktobjekts beschreibt. Der Treiber gibt Funktionszeiger auf seine Rückruffunktionen in dieser Struktur an. Diese Struktur wird von UCX verwaltet.

[in, optional] Attributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Attribute für das Endpunktobjekt angibt.

[out] Endpoint

Ein Zeiger auf eine Variable, die ein Handle für das neue Endpunktobjekt empfängt.

Rückgabewert

Die Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen geeigneten NTSTATUS Fehlercode zurück.

Bemerkungen

Der Clienttreiber für den Hostcontroller muss diese Methode aufrufen, nachdem der WdfDeviceCreate Aufruf aufgerufen wurde. Das übergeordnete Objekt des neuen Endpunktobjekts ist das USB-Geräteobjekt.

Die Methode initialisiert das Endpunktobjekt mit Informationen wie dem Typ des Endpunkts, der Pipe, der Übertragung und der maximalen Übertragungsgröße.

Ein Codebeispiel finden Sie unter EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
Zielplattform-	Fenster
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL-	PASSIVE_LEVEL

Freigeben über