Función AcxDeviceRemoveCircuitDevice (acxdevice.h)
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 |