UcxStaticStreamsCreate-Funktion (ucxsstreams.h)

Artikel
02/07/2025

Erstellt ein statisches Streams-Objekt.

Syntax

NTSTATUS UcxStaticStreamsCreate(
  [in]           UCXENDPOINT            Endpoint,
                 PUCXSSTREAMS_INIT      *StaticStreamsInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
                 UCXSSTREAMS            *StaticStreams
);

Parameter

[in] Endpoint

Ein Handle für das Endpunktobjekt, das statische Datenströme unterstützt. Der Clienttreiber hat das Handle in einem vorherigen Aufruf von UcxEndpointCreateabgerufen.

StaticStreamsInit

Ein Zeiger auf eine UCXSSTREAMS_INIT-Struktur, die verschiedene Konfigurationsvorgänge zum Erstellen des Datenstromobjekts 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 Streamobjekt angibt.

StaticStreams

Ein Zeiger auf eine Variable, die ein Handle für das neue Streamobjekt 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 Endpunktobjekt.

In der Regel ruft der Clienttreiber diese Methode in der Implementierung des EVT_UCX_USBDEVICE_ENDPOINT_ADD Ereignisrückrufs auf.

Anforderungen

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

Freigeben über