Función AcxStreamBridgeCreate (acxstreams.h)

La función AcxStreamBridgeCreate usa un ACX_STREAM_BRIDGE_CONFIG para crear un StreamBridge para un circuito.

Un ACXSTREAMBRIDGE lo usa un circuito para propagar la creación de una secuencia, 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).

Sintaxis

NTSTATUS AcxStreamBridgeCreate(
  ACXCIRCUIT                AcxCircuit,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_STREAM_BRIDGE_CONFIG Config,
  ACXSTREAMBRIDGE           *StreamBridge
);

Parámetros

AcxCircuit

Puntero a una ubicación que recibe un identificador para el objeto ACXCIRCUIT asociado. Para obtener más información sobre los objetos ACX, vea ACX : resumen de objetos ACX.

Attributes

Atributos adicionales definidos mediante un WDF_OBJECT_ATTRIBUTES que se usan para establecer los valores de los distintos objetos: limpieza y destrucción de devoluciones de llamada, tipo de contexto y para especificar su objeto primario. Para obtener más información, vea WDF_OBJECT_ATTRIBUTES estructura y la sección de comentarios de este tema.

Config

Estructura ACX_STREAM_BRIDGE_CONFIG que define la configuración.

StreamBridge

Puntero a una ubicación que recibe un identificador para el nuevo objeto 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

Un punto de conexión de audio es una colección de uno o varios circuitos de audio (objetos ACXCIRCUIT) que se ensamblan para crear una ruta de acceso de audio completa. Normalmente, un controlador ACX crea circuitos de audio para diferentes puntos de conexión de audio, aunque ACX no prohíbe los circuitos creados por el mismo controlador para formar parte de la misma colección del punto de conexión de audio, siempre y cuando pertenezcan a una pila de dispositivos diferente. Un punto de conexión de audio es una colección de circuitos de audio creados por los mismos controladores de audio o diferentes.

De forma predeterminada, el nuevo elemento primario del objeto ACXSTREAMBRIDGE es el ACXCIRCUIT especificado. Puede usar el miembro ParentObject de la estructura WDF_OBJECT_ATTRIBUTES para especificar un elemento primario diferente con ACXCIRCUIT como antecesor. El marco elimina el objeto ACXSTREAMBRIDGE cuando elimina el objeto primario.

El controlador puede eliminar el objeto ACXSTREAMBRIDGE cuando haya terminado de usar el objeto ; de lo contrario, el objeto permanecerá hasta que se elimine el elemento primario, que es el caso cuando se crea durante la inicialización o creación de ACXCIRCUIT.

Un pin se puede asociar a cero, uno o varios ACXSTREAMBRIDGEs. ACX busca en la lista de modo de procesamiento de señales de ACXPIN asociada una coincidencia del modo de procesamiento de señales de flujo. La búsqueda se detiene en la primera coincidencia.

ACX crea un ACXSTREAMBRIDGE predeterminado para un puente ACXCIRCUIT a ACXCIRCUIT si el controlador no crea uno y el controlador no deshabilite el control predeterminado del puente de flujo con la función AcxCircuitInitDisableDefaultStreamBridgeHandling.

Ejemplo

A continuación se muestra el uso de ejemplo.

    ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
    ACXSTREAMBRIDGE          bridge = NULL;
    
    ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
    bridgeCfg.InModesCount = 1;
    bridgeCfg.InModes      = inModes; 
    bridgeCfg.OutMode      = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;

    status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);

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

• Encabezado acxstreams.h