Freigeben über

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

Siehe auch