AcxStreamBridgeCreate-Funktion (acxstreams.h)
Die AcxStreamBridgeCreate-Funktion verwendet einen ACX_STREAM_BRIDGE_CONFIG, um einen StreamBridge für einen Schaltkreis zu erstellen.
Eine ACXSTREAMBRIDGE wird von einem Schaltkreis verwendet, um eine Datenstromerstellung, die Zustände der Datenstromü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.
Syntax
NTSTATUS AcxStreamBridgeCreate(
ACXCIRCUIT AcxCircuit,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_STREAM_BRIDGE_CONFIG Config,
ACXSTREAMBRIDGE *StreamBridge
);
Parameter
AcxCircuit
Ein Zeiger auf eine Position, die ein Handle für das zugeordnete ACXCIRCUIT-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX Objects.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES definiert werden, die zum Festlegen der Werte der verschiedenen Objekte verwendet werden: Bereinigen und Zerstören von Rückrufen, Kontexttyp und Angeben des übergeordneten Objekts. Weitere Informationen finden Sie unter WDF_OBJECT_ATTRIBUTES Struktur und den Anmerkungenabschnitt dieses Themas.
Config
Eine ACX_STREAM_BRIDGE_CONFIG Struktur, die die Konfiguration definiert. Diese Struktur enthält AUDIO_SIGNALPROCESSINGMODEs, InModes und OutModes, die zum Steuern des Audiosignalverarbeitungsmodus des Ausgabedatenstroms verwendet werden.
StreamBridge
Ein Zeiger auf eine Position, die ein Handle für das neue ACXSTREAMBRIDGE-Objekt empfängt.
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
Ein Audioendpunkt ist eine Sammlung eines oder mehrerer Audioschaltungen (ACXCIRCUIT-Objekte), die zum Erstellen eines vollständigen Audiopfads zusammengestellt werden. Ein ACX-Treiber erstellt normalerweise Audioschaltungen für verschiedene Audioendpunkte, obwohl ACX keine Schaltkreise verbietet, die vomselben Treiber erstellt wurden, teil der Sammlung desselben Audioendpunkts zu sein, solange sie zu einem anderen Gerätestapel gehören. Ein Audioendpunkt ist eine Sammlung von Audioschaltungen, die von denselben oder verschiedenen Audiotreibern erstellt werden.
Standardmäßig ist das übergeordnete Objekt des neuen ACXSTREAMBRIDGE-Objekts das angegebene ACXCIRCUIT.By default, the new ACXSTREAMBRIDGE object's parent is the specified ACXCIRCUIT. Sie können das ParentObject-Element der WDF_OBJECT_ATTRIBUTES-Struktur verwenden, um ein anderes übergeordnetes Element mit ACXCIRCUIT als Vorgänger anzugeben. Das Framework löscht das ACXSTREAMBRIDGE -Objekt, wenn es das übergeordnete Objekt löscht.
Ihr Treiber kann das ACXSTREAMBRIDGE-Objekt löschen, wenn es die Verwendung des Objekts abgeschlossen hat; andernfalls verbleibt das Objekt, bis das übergeordnete Objekt gelöscht wird. Dies ist der Fall, wenn es während der ACXCIRCUIT-Initialisierung/Erstellung erstellt wird.
Ein Pin kann null, einem oder mehreren ACXSTREAMBRIDGEs zugeordnet werden. ACX durchsucht die zugehörigen Signalverarbeitungsmodusliste nach einer Übereinstimmung im Datenstromsignalverarbeitungsmodus. Die Suche wird bei der ersten Übereinstimmung beendet.
ACX erstellt eine STANDARD-ACXSTREAMBRIDGE für eine ACXCIRCUIT-zu ACXCIRCUIT-Brücke, wenn der Treiber keins erstellt, und der Treiber hat die Standarddatenstrom-Brückenbehandlung mit der AcxCircuitInitDisableDefaultStreamBridgeHandling-Funktionnicht deaktiviert.
Beispiel
Die Beispielverwendung wird unten gezeigt.
ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
ACXSTREAMBRIDGE bridge = NULL;
ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
bridgeCfg.InModesCount = 1;
bridgeCfg.InModes = inModes;
bridgeCfg.OutMode = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;
status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);
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 |