Funzione AcxStreamBridgeAddStream (acxstreams.h)
La funzione AcxStreamBridgeAddStream aggiunge un ACXSTREAM esistente a un ACXSTREAMBRIDGE esistente. Per altre informazioni sugli oggetti ACX, vedere ACX - Riepilogo degli oggetti ACX.
Sintassi
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parametri
Bridge
Un oggetto ACXSTREAMBRIDGE viene usato da un circuito per propagare la creazione del flusso, le transizioni degli stati del flusso e le impostazioni DRM tra i segmenti di flusso del 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 dei valori NTSTATUS.
Commenti
I driver chiamano AcxStreamBridgeAddStreamStream in questi scenari:
(a) i driver vogliono selezionare manualmente ACXSTREAMBRIDGE da usare per ACXSTREAM corrente.
(b) i driver (e i loro requisiti hardware) hanno una necessità per gli ACXCIRCUITs di livello inferiore, ad esempio i circuiti più vicini al pin del bridge del dispositivo, per intervenire prima che ACXCIRCUITs di livello superiore venga eseguita l'azione.
(c) i driver devono intervenire prima e dopo gli ACLXCIRCUITs a livello inferiore.
Per un tipo AcxStreamBridgeMux, viene creato un solo ACXSTREAM a livello inferiore indipendentemente dal numero di acXSTREAMs di input aggiunti a questo bridge. Ciò significa che l'output ACXSTREAM (che per il circuito locale viene rappresentato con un ACXTARGETSTREAM), viene creato solo per il primo ACXSTREAM aggiunto a ACXSTREAMBRIDGE. Qualsiasi altro input ACXSTREAMs, basta fare riferimento a questo ACXTARGETSTREAM esistente.
Per un tipo AcxSTreamBridgeMux, l'output ACXTARGETSTREAM viene rimosso quando l'ultimo input ACXSTREAM viene rimosso dall'ACXSTREAMBRIDGE con AcxStreamBridgeRemoveStream.
Esempio
Di seguito è riportato l'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 ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxstreams.h |
| IRQL | PASSIVE_LEVEL |