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

  • Статья

Функция AcxDeviceAddCircuit добавляет канал ACX в WDFDEVICE для создания конечной точки звука.

Синтаксис

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Параметры

Device

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

Circuit

Канал, добавляемый к устройству.

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

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

Комментарии

Звуковой канал является основным стандартным блоком ACX. Аудиодрайвер создает один или несколько объектов цепи ACX для представления частичных или полных звуковых данных и пути управления. ACX собирает эти объекты цепи ACX вместе, чтобы создать полный звуковой путь, представляющий конечную точку звука.

Эту функцию можно вызывать только из функции обратного вызова EVT_WDF_DEVICE_PREPARE_HARDWARE для этого устройства.

Пример

WDFDEVICE             Device;
NTSTATUS              status;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

Требования ACX

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

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

Требования

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

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