Поделиться через


Функция AcxDeviceAddCircuitDevice (acxdevice.h)

Функция AcxDeviceAddCircuitDevice добавляет устройство цепи ACX в указанное родительское устройство, представляющее звуковой путь.

Синтаксис

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Параметры

ParentDevice

Объект WDFDEVICE, представляющий родительский объект, к которому будет добавлено устройство канала.

Device

WDFDEVICE, представляющий устройство канала для добавления к родительскому устройству.

Возвращаемое значение

AcxDeviceAddCircuitDevice возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае возвращается код ошибки NTSTATUS .

Комментарии

Аудиодрайверы используют эту функцию для перечисления новой конечной точки звука.

Эту функцию можно вызвать в любое время в течение жизненного цикла драйвера. Plug and Play сериализует перечисление устройства и связанных каналов в связи с другими Plug and Play действиями на родительском и одноуровневом устройствах.

Пример

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;
}

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование Значение
Заголовок acxdevice.h
IRQL PASSIVE_LEVEL

См. также раздел