Share via

Función AcxDeviceRemoveCircuitDevice (acxdevice.h)

  • Artículo

La función AcxDeviceRemoveCircuitDevice quita un dispositivo de circuito ACX de un dispositivo primario especificado.

Sintaxis

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Parámetros

ParentDevice

WDFDEVICE primario del que se va a quitar el dispositivo del circuito ACX.

Device

WDFDEVICE que representa el dispositivo de circuito que se va a quitar del dispositivo primario.

Valor devuelto

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

Comentarios

Los controladores de audio usan esta función para quitar un punto de conexión de audio existente.

Se puede llamar a esta función en cualquier momento durante el ciclo de vida del controlador. Plug and Play se encarga de serializar la eliminación del dispositivo y los circuitos asociados, en relación con otras actividades de Plug and Play en los dispositivos primarios y del mismo nivel.

Ejemplo

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

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