AcxStreamBridgeAddStream-Funktion (acxstreams.h)
Die AcxStreamBridgeAddStream-Funktion fügt einem vorhandenen ACXSTREAMBRIDGE einen vorhandenen ACXSTREAMBRIDGE hinzu. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX Objects.
Syntax
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parameter
Bridge
Ein ACXSTREAMBRIDGE--Objekt wird von einem Schaltkreis verwendet, um die Datenstromerstellung, die Statusübergänge und DRM-Einstellungen zwischen den Schaltkreisstromsegmenten des Endpunkts zu verteilen. Dieses Objekt wird nur in einem Szenario mit mehreren Schaltkreisen (Audio composite) verwendet.
Stream
Ein ACXSTREAM -Objekt stellt einen Von einem Schaltkreis erstellten Audiodatenstrom dar. Der Datenstrom besteht aus einer Liste von Elementen, die basierend auf den Elementen des übergeordneten Schaltkreises erstellt wurden.
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
Treiber rufen AcxStreamBridgeAddStream in folgenden Szenarien auf:
(a) Treiber möchten manuell die ACXSTREAMBRIDGE auswählen, die für den aktuellen ACXSTREAM verwendet werden soll.
(b) Treiber (und ihre Hardwareanforderungen) benötigen die downlevel ACXCIRCUITs, d. h. die Schaltungen näher am Gerätebrückenstift, um Maßnahmen zu ergreifen, bevor ACXCIRCUITs der oberen Ebene maßnahmen ergreifen.
(c) Treiber müssen vor und nach der Abwärtsstufe ACXCIRCUITs Maßnahmen ergreifen.
Bei einem AcxStreamBridgeMux-Typ wird nur ein Abwärts-ACXSTREAM unabhängig von der Anzahl der Eingabe-ACXSTREAMs erstellt, die dieser Brücke hinzugefügt wurden. Dies bedeutet, dass die Ausgabe ACXSTREAM (die für den lokalen Schaltkreis der Datenstrom mit einem ACXTARGETSTREAM dargestellt wird) nur für den ersten ACXSTREAM erstellt wird, der der ACXSTREAMBRIDGE hinzugefügt wird. Alle zusätzlichen Eingaben ACXSTREAMs, nehmen Sie einfach einen Verweis auf diesen vorhandenen ACXTARGETSTREAM.
Bei einem AcxSTreamBridgeMux-Typ wird die Ausgabe ACXTARGETSTREAM entfernt, wenn die letzte Eingabe ACXSTREAM aus der ACXSTREAMBRIDGE mit AcxStreamBridgeRemoveStream entfernt wird.
Beispiel
Die Beispielverwendung wird unten gezeigt. 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
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 |