AcxStreamAddConnections, fonction (acxstreams.h)
La fonction AcxStreamAddConnections ajoute des connexions explicites à un nouveau flux ACX pendant EvtAcxCircuitCreateStream
Syntaxe
NTSTATUS AcxStreamAddConnections(
ACXSTREAM Stream,
PACX_CONNECTION Connections,
ULONG ConnectionsCount
);
Paramètres
Stream
Objet de flux ACXSTREAM existant. Pour plus d’informations, consultez ACX - Résumé des objets ACX.
Connections
Structure ACX_CONNECTION qui contient des informations sur les connexions pour ajouter le flux.
ConnectionsCount
Nombre de connexions dans le flux. Il s’agit d’un nombre basé sur 1.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Si le pilote n’appelle pas AcxStreamAddConnections pendant EvtAcxCircuitCreateStream, l’infrastructure ACX affecte automatiquement les connexions entre les objets ACXELEMENT qui ont été ajoutés à ACXSTREAM.
Exemple
L’exemple d’utilisation est illustré ci-dessous.
//
// Explicitly connect the elements of the stream. Note that the driver doesn't
// need to perform this step when elements are connected in the same order
// as they were added to the stream.
//
const int numElements = 2;
const int numConnections = numElements + 1;
ACXSTREAM Stream;
ACX_CONNECTION connections[numConnections];
ACX_CONNECTION_INIT(&connections[0], Stream, Elements[ElementCount - 2]);
ACX_CONNECTION_INIT(&connections[1], Elements[ElementCount - 2], Elements[ElementCount - 1]);
ACX_CONNECTION_INIT(&connections[2], Elements[ElementCount - 1], Stream);
//
// Add the connections linking stream to elements.
//
status = AcxStreamAddConnections(Stream, connections, SIZEOF_ARRAY(connections));
Configuration requise pour ACX
Version ACX minimale : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxstreams.h |
| IRQL | PASSIVE_LEVEL |