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 à ajouter le flux.
ConnectionsCount
Nombre de connexions qui se trouvent dans le flux. Il s’agit d’un nombre basé sur 1.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Si le pilote n’appelle pas AcxStreamAddConnections pendant EvtAcxCircuitCreateStream, l’infrastructure ACX affecte automatiquement des connexions entre les objets ACXELEMENT 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 minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxstreams.h |
| IRQL | PASSIVE_LEVEL |