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

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

  • Статья

Функция AcxDeviceRemoveCircuit удаляет указанный звуковой канал с устройства ACX.

Синтаксис

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Параметры

Device

WDFDEVICE, из которого удаляется звуковой канал, заданный параметром Circuit.

Circuit

Звуковой канал для удаления из WDFDEVICE, указанного параметром Device .

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

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

Комментарии

Используйте AcxDeviceAddCircuit для добавления звукового канала в WDFDEVICE.

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

Пример

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

Требования к ACX

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

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

Требования

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

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