Compartir a través de

Función AcxDeviceAddCircuit (acxdevice.h)

  • Artículo

La función AcxDeviceAddCircuit agrega un circuito ACX a un WDFDEVICE para crear un punto de conexión de audio.

Sintaxis

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parámetros

Device

WDFDEVICE que representa el dispositivo al que se agregará el circuito.

Circuit

Circuito que se va a agregar al dispositivo.

Valor devuelto

AcxDeviceAddCircuit devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error NTSTATUS .

Comentarios

El circuito de audio es el bloque de creación principal de ACX. Un controlador de audio crea uno o varios objetos de circuito ACX para representar una ruta de acceso de control y datos de audio parciales o completos. ACX ensambla estos objetos de circuito ACX para crear una ruta de acceso de audio completa que representa un punto de conexión de audio.

Esta función solo se puede llamar desde la función de devolución de llamada EVT_WDF_DEVICE_PREPARE_HARDWARE para este dispositivo.

Ejemplo

WDFDEVICE             Device;
NTSTATUS              status;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

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

Consulte también