UcxEndpointGetStaticStreamsReferenced-Funktion (ucxendpoint.h)

Artikel
02/07/2025

Gibt ein Objekt für statische Datenströme für den angegebenen Endpunkt zurück.

Syntax

UCXSSTREAMS UcxEndpointGetStaticStreamsReferenced(
  [in] UCXENDPOINT Endpoint,
  [in] PVOID       Tag
);

Parameter

[in] Endpoint

Ein Handle für das Endpunktobjekt, für das das statische Streams-Objekt angefordert wird. Der Clienttreiber hat das Handle in einem vorherigen Aufruf von UcxEndpointCreateabgerufen.

[in] Tag

Ein vom Framework definierter Wert, der als Identifikationstag für den Objektverweis gespeichert wird.

Rückgabewert

Ein Handle für das Streamobjekt, wenn es mit dem Endpunkt geöffnet wird. Andernfalls NULL.

Bemerkungen

Der Clienttreiber kann diese Funktion verwenden, um zu bestimmen, ob es ein Streams-Objekt für diesen Endpunkt erstellt hat. Wenn das Objekt erstellt wird, gibt die Methode das UCXSSTREAMS-Handle zurück. Die Methode gibt NULL zurück, wenn das Objekt nicht erstellt wurde oder wenn der Clienttreiber das framework-Anforderungsobjekt fehlgeschlagen ist, das im EVT_UCX_ENDPOINT_STATIC_STREAMS_ENABLE Rückruf übergeben wurde. Jeder Aufruf dieser Methode muss mit einem Aufruf von WdfObjectDereferenceWithTag- mit demselben Tag abgeglichen werden.

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-	<=DISPATCH_LEVEL

Siehe auch

UcxEndpointCreate

Freigeben über