Función AcxCircuitAddPins (acxcircuit.h)
La función AcxCircuitAddPins agrega patillas a 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.
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
Un ACXCIRCUIT tiene al menos un pin de entrada (ACXPIN) y un pin de salida (ACXPIN), y puede agregar uno o varios ACXELEMENT.
Cada ACXCIRCUIT tiene al menos una patilla receptor y una patilla source. 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 flujo creado a partir del circuito. En el caso de un circuito Capture, la patilla receptor se usa para controlar el comportamiento de captura (propiedades del dispositivo) de cualquier flujo creado a partir del circuito.
ACXPIN es el objeto utilizado para controlar el streaming en la ruta de acceso de audio. Para 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 |
|---|---|
| encabezado de | acxcircuit.h |
| irQL | PASSIVE_LEVEL |