AcxStreamBridgeAddStream-Funktion (acxstreams.h)

  • Artikel

Die AcxStreamBridgeAddStream-Funktion fügt einem vorhandenen ACXSTREAMBRIDGE einen vorhandenen ACXSTREAM hinzu. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX-Objekten.

Syntax

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Parameter

Bridge

Ein ACXSTREAMBRIDGE-Objekt wird von einer Verbindung verwendet, um die Datenstromerstellung, die Statusübergänge des Datenstroms und die DRM-Einstellungen zwischen den Leitungsstreamsegmenten des Endpunkts zu verteilen. Dieses Objekt wird nur in einem Szenario mit mehreren Schaltungen (Audio-Verbund) verwendet.

Stream

Ein ACXSTREAM-Objekt stellt einen audiostream dar, der von einer Verbindung erstellt wird. Der Stream besteht aus einer Liste von Elementen, die basierend auf den Elementen der übergeordneten Verbindung erstellt wurden.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Hinweise

Treiber rufen AcxStreamBridgeAddStream in diesen Szenarien auf:

(a) Treiber möchten die ACXSTREAMBRIDGE manuell auswählen, die für den aktuellen ACXSTREAM verwendet werden soll.

(b) Treiber (und ihre Hardwareanforderungen) benötigen die ACXCIRCUITs auf downlevel, d. h. die Schaltungen, die näher am Geräte-Bridge-Pin liegen, um Maßnahmen zu ergreifen, bevor ACXCIRCUITs der oberen Ebene maßnahmen.

(c) Die Treiber müssen vor und nach den ACXCIRCUITs auf downleveln Maßnahmen ergreifen.

Für einen AcxStreamBridgeMux-Typ wird unabhängig von der Anzahl der dieser Bridge hinzugefügten ACXSTREAMs nur ein ACXSTREAM-Downlevel erstellt. Dies bedeutet, dass die ACXSTREAM-Ausgabe (die für die lokale Leitung mit einem ACXTARGETSTREAM dargestellt wird) nur für den ersten ACXSTREAM erstellt wird, der der ACXSTREAMBRIDGE hinzugefügt wurde. Alle zusätzlichen Eingabe-ACXSTREAMs, nehmen Sie einfach einen Verweis auf diesen vorhandenen ACXTARGETSTREAM.

Bei einem AcxSTreamBridgeMux-Typ wird die ACXTARGETSTREAM-Ausgabe entfernt, wenn der letzte Eingabe-ACXSTREAM mit AcxStreamBridgeRemoveStream aus der ACXSTREAMBRIDGE entfernt wird.

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt. Fehlerbehandlungscode wird nicht angezeigt.

        status = AcxStreamBridgeCreate(Circuit, &attributes, &bridgeCfg, &bridge);

        // Pin ID 1 is the bridge pin in this example.
        bridgePin = AcxCircuitGetPinById(Circuit, 1);
        
        status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);

        status = AcxStreamBridgeAddStream(bridge, stream);

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxstreams.h
IRQL PASSIVE_LEVEL

Weitere Informationen