UcxEndpointCreate-Funktion (ucxendpoint.h)

Erstellt einen Endpunkt auf dem angegebenen 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 UcxUsbDeviceCreate abgerufen.

[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.

Hinweise

Der Clienttreiber für den Hostcontroller muss diese Methode nach dem WdfDeviceCreate-Aufruf aufrufen. Das übergeordnete Element des neuen Endpunktobjekts ist das USB-Geräteobjekt.

Die -Methode initialisiert das Endpunktobjekt mit Informationen wie Endpunkttyp, Pipe, Übertragung und maximale Übertragungsgröße.

Ein Codebeispiel finden Sie unter EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Zielplattform	Windows
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL	PASSIVE_LEVEL