Función AcxStreamBridgeAddStream (acxstreams.h)
La función AcxStreamBridgeAddStream agrega una ACXSTREAM existente a acXSTREAMBRIDGE existente. Para obtener más información sobre los objetos ACX, vea ACX - Resumen de objetos ACX.
Sintaxis
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parámetros
Bridge
Un objeto ACXSTREAMBRIDGE lo usa un circuito para propagar la creación de flujos, los estados de la secuencia realiza transiciones 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.
Valor devuelto
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 Using NTSTATUS Values.
Observaciones
Los controladores llaman a AcxStreamBridgeAddStream en estos escenarios:
(a) los controladores quieren seleccionar manualmente acXSTREAMBRIDGE para usarlo para acXSTREAM actual.
(b) los controladores (y sus requisitos de hardware) tienen la necesidad de que los ACXCIRCUIT de nivel inferior, es decir, los circuitos más cerca del pin de puente del dispositivo, tomen medidas antes de que los ACXCIRCUIT 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 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 la última entrada ACXSTREAM de ACXSTREAMBRIDGE con AcxStreamBridgeRemoveStream.
Ejemplo
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);
Requisitos de ACX
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.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | acxstreams.h |
| irQL | PASSIVE_LEVEL |