AcxStreamAddConnections-Funktion (acxstreams.h)
Die AcxStreamAddConnections--Funktion fügt während EvtAcxCircuitCreateStream explizite Verbindungen zu einem neuen ACX-Datenstrom hinzu.
Syntax
NTSTATUS AcxStreamAddConnections(
ACXSTREAM Stream,
PACX_CONNECTION Connections,
ULONG ConnectionsCount
);
Parameter
Stream
Ein vorhandenes ACXSTREAM-Streamobjekt. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX Objects.
Connections
Eine ACX_CONNECTION Struktur, die Informationen zu den Verbindungen zum Hinzufügen des Datenstroms enthält.
ConnectionsCount
Die Anzahl der Verbindungen, die sich im Datenstrom befinden. Dies ist eine 1 basierte Anzahl.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Wenn der Treiber acxStreamAddConnections während evtAcxCircuitCreateStream nicht aufruft, weist das ACX-Framework automatisch Verbindungen zwischen allen ACXELEMENT-Objekten zu, die dem ACXSTREAM hinzugefügt wurden.
Beispiel
Die Beispielverwendung wird unten gezeigt.
//
// 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));
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxstreams.h |
| IRQL- | PASSIVE_LEVEL |