UcxStaticStreamsCreate, fonction (ucxsstreams.h)

  • Article

Crée un objet de flux statique.

Syntaxe

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

Paramètres

[in] Endpoint

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

StaticStreamsInit

Pointeur vers une structure de UCXSSTREAMS_INIT qui décrit diverses opérations de configuration pour créer l’objet stream. Le pilote spécifie des 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 de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui spécifie des attributs pour l’objet stream.

StaticStreams

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

Valeur retournée

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

Remarques

Le pilote client pour le 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 endpoint.

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 .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Plateforme cible Windows
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête ucxsstreams.h (inclure Ucxclass.h, Ucxstreams.h)
IRQL PASSIVE_LEVEL