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
El primario WDFDEVICE del que se va a quitar el dispositivo del circuito ACX.
Device
El 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.
Observaciones
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 |
|---|---|
| encabezado de | acxdevice.h |
| irQL | PASSIVE_LEVEL |