Share via

Función AcxDeviceRemoveCircuit (acxdevice.h)

  • Artículo

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

Sintaxis

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parámetros

Device

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 .

Comentarios

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

Esta función solo se puede llamar 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
Header acxdevice.h
IRQL PASSIVE_LEVEL

Consulte también