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

Статья
02/06/2025

Функция 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

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