Share via

Función AcxCircuitAddPins (acxcircuit.h)

  • Artículo

La función AcxCircuitAddPins agrega patillas a un ACXCIRCUIT.

Sintaxis

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

Parámetros

Circuit

Objeto ACXCIRCUIT existente. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Pins

Objeto ACXPIN existente que se agregará al circuito.

PinsCount

Número de patillas que se agregarán al circuito. Se trata de un recuento basado en uno.

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 ACXCIRCUIT tiene al menos un pin de entrada (ACXPIN) y un pin de salida (ACXPIN), y puede agregar uno o varios ACXELEMENTs.

Cada ACXCIRCUIT tiene al menos un pin receptor y un pin de origen. El marco ACX usa estos pines para exponer las conexiones del circuito a la pila de audio. Para un circuito Render, el pin source se usa para controlar el comportamiento de representación (propiedades del dispositivo) de cualquier secuencia creada a partir del circuito. En el caso de un circuito Capture, el anclaje Sink se usa para controlar el comportamiento de captura (propiedades del dispositivo) de cualquier secuencia creada a partir del circuito.

ACXPIN es el objeto que se usa para controlar el streaming en la ruta de acceso de audio. En el caso de topologías ACXCIRCUIT simples, ACX puede crear automáticamente el otro ACXPIN si solo hay uno presente.

Ejemplo

A continuación se muestra el uso de ejemplo.

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

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

Consulte también