Funzione AcxStreamBridgeAddStream (acxstreams.h)
La funzione AcxStreamBridgeAddStreamAddStream aggiunge un oggetto ACXSTREAM esistente a un OGGETTO ACXSTREAMBRIDGE esistente. Per altre informazioni sugli oggetti ACX, vedere ACX - Summary of ACX Objects.
Sintassi
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parametri
Bridge
Un oggetto ACXSTREAMBRIDGE viene usato da un circuito per propagare la creazione del flusso, gli stati del flusso e le impostazioni DRM tra i segmenti del flusso di circuito dell'endpoint. Questo oggetto viene usato solo in uno scenario multi circuito (composito audio).
Stream
Un oggetto ACXSTREAM rappresenta un flusso audio creato da un circuito. Il flusso è costituito da un elenco di elementi creati in base agli elementi del circuito padre.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.
Osservazioni
I driver chiamano AcxStreamBridgeAddStream in questi scenari:
(a) i driver vogliono selezionare manualmente ACXSTREAMBRIDGE da usare per l'ACXSTREAM corrente.
(b) i driver (e i relativi requisiti hardware) hanno bisogno di ACXCIRCUITs di livello inferiore, ovvero i circuiti più vicini al pin del bridge del dispositivo, per intervenire prima che gli ACXCIRCUIT di livello superiore eseseguono azioni.
(c) i driver devono intervenire prima e dopo le ACXCIRCUIT di livello inferiore.
Per un tipo AcxStreamBridgeMux, viene creato un solo oggetto ACXSTREAM di livello inferiore indipendentemente dal numero di ACXSTREAM di input aggiunti a questo bridge. Ciò significa che l'output ACXSTREAM (che per il circuito locale il flusso è rappresentato con ACXTARGETSTREAM), viene creato solo per il primo ACXSTREAM aggiunto a ACXSTREAMBRIDGE. Qualsiasi input aggiuntivo ACXSTREAMs, è sufficiente fare riferimento a questo ACXTARGETSTREAM esistente.
Per un tipo AcxSTreamBridgeMux, l'output ACXTARGETSTREAM viene rimosso quando l'ultimo input ACXSTREAM viene rimosso da ACXSTREAMBRIDGE con AcxStreamBridgeRemoveStream.
Esempio
Di seguito è riportato un esempio di utilizzo. Il codice di gestione degli errori non viene visualizzato.
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);
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxstreams.h |
| IRQL | PASSIVE_LEVEL |