Share via

Función AcxStreamBridgeRemoveStream (acxstreams.h)

  • Artículo

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, 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.

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 Uso de valores NTSTATUS.

Comentarios

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.

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
Header acxstreams.h
IRQL PASSIVE_LEVEL

Consulte también