Función AcxStreamBridgeAddStream (acxstreams.h)
La función AcxStreamBridgeAddStream agrega una ACXSTREAM existente a un ACXSTREAMBRIDGE existente. Para obtener más información sobre los objetos ACX, vea ACX : resumen de objetos ACX.
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Bridge
Un circuito usa un objeto ACXSTREAMBRIDGE para propagar la creación de flujos, las transiciones de estados de la secuencia y la configuración de DRM entre los segmentos de flujo de circuito del punto de conexión. Este objeto solo se usa en un escenario de varios circuitos (compuestos de audio).
Stream
Un objeto ACXSTREAM representa una secuencia de audio creada por un circuito. La secuencia se compone de una lista de elementos creados en función de los elementos del circuito primario.
Devuelve STATUS_SUCCESS
si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.
Los controladores llaman a AcxStreamBridgeAddStream en estos escenarios:
(a) los controladores quieren seleccionar manualmente ACXSTREAMBRIDGE para usarlo para el ACXSTREAM actual.
(b) los controladores (y sus requisitos de hardware) tienen la necesidad de que los ACXCIRCUITs de nivel inferior, es decir, los circuitos más cercanos al pin del puente del dispositivo, tomen medidas antes de que acXCIRCUITs de nivel superior tomen medidas.
(c) los controladores deben tomar medidas antes y después de los ACXCIRCUIT de nivel inferior.
Para un tipo AcxStreamBridgeMux, solo se crea un ACXSTREAM de nivel inferior independientemente del número de ACXSTREAMs de entrada agregados a este puente. Esto significa que la salida ACXSTREAM (que para el circuito local representa la secuencia con una ACXTARGETSTREAM), solo se crea para el primer ACXSTREAM agregado a ACXSTREAMBRIDGE. Cualquier ACXSTREAMs de entrada adicional, simplemente tome una referencia a este ACXTARGETSTREAM existente.
Para un tipo AcxSTreamBridgeMux, la salida ACXTARGETSTREAM se quita cuando se quita el último ACXSTREAM de entrada de ACXSTREAMBRIDGE con AcxStreamBridgeRemoveStream.
A continuación se muestra el uso de ejemplo. No se muestra el código de control de errores.
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);
Versión mínima de ACX: 1.0
Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.
Requisito | Valor |
---|---|
Header | acxstreams.h |
IRQL | PASSIVE_LEVEL |