UcxStaticStreamsCreate, fonction (ucxsstreams.h)

Article
02/07/2025

Crée un objet de flux statiques.

Syntaxe

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

Paramètres

[in] Endpoint

Handle vers l’objet de point de terminaison qui prend en charge les flux statiques. Le pilote client a récupéré le handle dans un appel précédent pour UcxEndpointCreate.

StaticStreamsInit

Pointeur vers une structure UCXSSTREAMS_INIT qui décrit différentes opérations de configuration pour la création de l’objet de flux. Le pilote spécifie les pointeurs de fonction vers ses fonctions de rappel dans cette structure. Cette structure est gérée par UCX.

[in, optional] Attributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui spécifie les attributs de l’objet de flux.

StaticStreams

Pointeur vers une variable qui reçoit un handle vers le nouvel objet de flux.

Valeur de retour

La méthode retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une appropriée code d’erreur NTSTATUS.

Remarques

Le pilote client du contrôleur hôte doit appeler cette méthode après l’appel WdfDeviceCreate. Le parent du nouvel objet de point de terminaison est l’objet de point de terminaison.

En règle générale, le pilote client appelle cette méthode dans son implémentation du rappel d’événement EVT_UCX_USBDEVICE_ENDPOINT_ADD.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
plateforme cible	Windows
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	ucxsstreams.h (include Ucxclass.h, Ucxstreams.h)
IRQL	PASSIVE_LEVEL

Partager via