Función AcxDeviceAddCircuitDevice (acxdevice.h)
La función AcxDeviceAddCircuitDevice agrega un dispositivo de circuito ACX a un dispositivo primario especificado que representa una ruta de acceso de audio.
Sintaxis
NTSTATUS AcxDeviceAddCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parámetros
ParentDevice
Un WDFDEVICE que representa el elemento primario al que se agregará el dispositivo del circuito.
Device
Un WDFDEVICE que representa el dispositivo de circuito que se va a agregar al dispositivo primario.
Valor devuelto
acxDeviceAddCircuitDevice 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 enumerar un nuevo punto de conexión de audio.
Se puede llamar a esta función en cualquier momento durante el ciclo de vida del controlador. Plug and Play serializa la enumeració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
WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS status;
// Code to initialize the WDFDEVICE...
// Code to create the WDFDEVICE renderDevice...
//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
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 |