Compartir a través de


Función AcxDeviceRemoveCircuit (acxdevice.h)

La función AcxDeviceRemoveCircuit quita el circuito de audio especificado de un dispositivo ACX.

Sintaxis

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parámetros

Device

El WDFDEVICE del que se va a quitar el circuito de audio especificado por el parámetro Circuit.

Circuit

Circuito de audio que se va a quitar del WDFDEVICE especificado por el parámetro Device.

Valor devuelto

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

Observaciones

Use AcxDeviceAddCircuit para agregar un circuito de audio a un WDFDEVICE.

Solo se puede llamar a esta función desde la función de devolución de llamada EVT_WDF_DEVICE_RELEASE_HARDWARE para este dispositivo.

Ejemplo

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

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

Consulte también