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.
NTSTATUS AcxStreamBridgeRemoveStream(
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
Identificador del objeto ACXSTREAM que se va a quitar de ACXSTREAMBRIDGE.
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.
Esta DDI solo se puede llamar desde el contexto del controlador de limpieza de flujos del controlador. 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 de h/w) necesitan que los ACXSTREAMs de nivel superior, es decir, los flujos de circuito más cerca del pin del puente de streaming, tomen 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 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.
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);
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 |