AcxStreamBridgeRemoveStream-Funktion (acxstreams.h)
Die AcxStreamBridgeRemoveStream-Funktion entfernt den angegebenen ACXSTREAM aus dem ACXSTREAMBRIDGE-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX-Objekten.
Syntax
NTSTATUS AcxStreamBridgeRemoveStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parameter
Bridge
Ein ACXSTREAMBRIDGE-Objekt wird von einer Leitung verwendet, um die Streamerstellung, 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 (Audioverbund) verwendet.
Stream
Ein Handle für das ACXSTREAM-Objekt, das aus der ACXSTREAMBRIDGE entfernt werden soll.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Hinweise
Dieser DDI kann nur aus dem Kontext des Streambereinigungshandlers des Treibers aufgerufen werden. Der Aufrufer ruft diesen DDI auf, um eine Eingabe-ACXSTREAM-Instanz manuell vom angegebenen ACXSTREAMBRIDGE-Objekt zu trennen.
Treiber rufen AcxStreamBridgeRemoveStream in diesen Szenarien auf:
(a) Treiber möchten den ACXSTREAM manuell aus der ACXSTREAMBRIDGE entfernen.
(b) Treiber (und ihre S/W-Anforderungen) müssen für die ACXSTREAMs der oberen Ebene, d. h. die Leitungsströme, die näher an den Streaming-Bridge-Pin gestreamt werden, um Maßnahmen vor ACXSTREAMs auf downlevel zu ergreifen.
(c) Die Fahrer müssen maßnahmen ergreifen, bevor und nachdem der ACXSTREAM-Abwärtslevel abfällt.
Für einen AcxStreamBridgeMux-Typ wird unabhängig von der Anzahl der dieser Brücke hinzugefügten Eingabe-ACXSTREAMs nur ein ACXSTREAM-Downlevel erstellt. Dies bedeutet, dass der ACXSTREAM-Ausgang (der 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 einfach einen Verweis auf diesen vorhandenen ACXTARGETSTREAM.
Bei einem AcxStreamBridgeMux-Typ wird die Ausgabe ACXTARGETSTREAM entfernt, wenn die letzte Eingabe ACXSTREAM mit AcxStreamBridgeRemoveStream aus der ACXSTREAMBRIDGE entfernt wird.
Beispiel
Die Verwendungsbeispiele finden Sie unten.
status = AcxStreamBridgeAddStream(bridge, stream);
// Get I/O target to send I/O to the target stream.
targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
// Target stream is closed if this was last input ACXSTREAM removed.
status = AcxStreamBridgeRemoveStream(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 |