Share via

Función AcxDeviceAddCircuitDevice (acxdevice.h)

  • Artículo

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

WDFDEVICE que representa el elemento primario al que se agregará el dispositivo de circuito.

Device

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 .

Comentarios

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 relacionados.

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
Header acxdevice.h
IRQL PASSIVE_LEVEL

Consulte también