Función AcxStreamBridgeRemoveStream (acxstreams.h)
La función acxStreamBridgeRemoveStream quita el ACXSTREAM especificado del objeto ACXSTREAMBRIDGE . Para obtener más información sobre los objetos ACX, vea ACX - Resumen de objetos ACX.
Sintaxis
NTSTATUS AcxStreamBridgeRemoveStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
Parámetros
Bridge
Un circuito usa un objeto ACXSTREAMBRIDGE para propagar la creación de flujos, los estados de la secuencia realizan 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
Identificador del objeto ACXSTREAM que se va a quitar de ACXSTREAMBRIDGE.
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
Este DDI solo se puede llamar desde el contexto del controlador de limpieza de flujos. El autor de la llamada invoca a este DDI para desasociar manualmente una entrada ACXSTREAM del objeto ACXSTREAMBRIDGE especificado.
Los controladores llaman a AcxStreamBridgeRemoveStream en estos escenarios:
(a) los controladores quieren quitar manualmente el ACXSTREAM de ACXSTREAMBRIDGE.
(b) los controladores (y sus requisitos h/w) necesitan para los ACXSTREAMs de nivel superior, es decir, los flujos de circuito más cerca del pin del puente de streaming, para tomar medidas antes de acXSTREAMs de nivel inferior.
(c) los controladores deben tomar medidas antes y después de que el ACXSTREAM de nivel inferior desaparezca.
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 entrada adicional ACXSTREAMs 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.
status = AcxStreamBridgeAddStream(bridge, stream);
// Get I/O target to send I/O to the target stream.
targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
// Target stream is closed if this was last input ACXSTREAM removed.
status = AcxStreamBridgeRemoveStream(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 |