AcxStreamBridgeCreate-Funktion (acxstreams.h)

  • Artikel

Die AcxStreamBridgeCreate-Funktion verwendet eine ACX_STREAM_BRIDGE_CONFIG, um eine StreamBridge für eine Verbindung zu erstellen.

Eine ACXSTREAMBRIDGE wird von einer Leitung verwendet, um eine Streamerstellung, die Statusübergänge des Streams und DIE DRM-Einstellungen zwischen den Leitungsstreamsegmenten des Endpunkts zu verteilen. Dieses Objekt wird nur in einem Szenario mit mehreren Schaltungen (Audioverbund) 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 auf das zugeordnete ACXCIRCUIT-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX-Objekten.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES definiert werden, die zum Festlegen der Werte des verschiedenen Objekts 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 im Abschnitt "Hinweise" dieses Themas.

Config

Eine ACX_STREAM_BRIDGE_CONFIG-Struktur , die die Konfiguration definiert.

StreamBridge

Ein Zeiger auf eine Position, die ein Handle auf das neue ACXSTREAMBRIDGE-Objekt empfängt.

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

Ein Audioendpunkt ist eine Sammlung von mindestens einer Audioschaltung (ACXCIRCUIT-Objekte), die zum Erstellen eines vollständigen Audiopfads zusammengesetzt werden. Ein ACX-Treiber erstellt normalerweise Audioschaltungen für verschiedene Audioendpunkte, obwohl ACX nicht verhindert, dass vom gleichen Treiber erstellte Leitungen Teil der Sammlung desselben Audioendpunkts sind, solange sie zu einem anderen Gerätestapel gehören. Ein Audioendpunkt ist eine Sammlung von Audioschaltungen, die von demselben oder unterschiedlichen Audiotreibern erstellt werden.

Standardmäßig ist das übergeordnete Element des neuen ACXSTREAMBRIDGE-Objekts das angegebene 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 er das Objekt verwendet 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 0, einem oder mehreren ACXSTREAMBRIDGEs zugeordnet werden. ACX durchsucht die liste des zugeordneten ACXPIN-Signalverarbeitungsmodus nach einer Übereinstimmung mit dem Streamsignalverarbeitungsmodus. Die Suche wird bei der ersten Übereinstimmung beendet.

ACX erstellt eine ACXSTREAMBRIDGE-Standardbrücke für eine ACXCIRCUIT-zu-ACXCIRCUIT-Brücke, wenn der Treiber keines erstellt, und der Treiber hat die Standarddatenstrombrückenbehandlung nicht mit der AcxCircuitInitDisableDefaultStreamBridgeHandling-Funktion deaktiviert.

Beispiel

Die Verwendungsbeispiele finden Sie unten.

    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

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