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

Статья
02/06/2025

Функция AcxDeviceDetachCircuit отсоединяет звуковой канал от WDFDEVICE до удаления.

Синтаксис

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Параметры

Device

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

Circuit

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

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

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

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

AcxDeviceDetachCircuit отсоединяет канал от устройства. Вызывающий объект отвечает за удаление объекта ACXCIRCUIT.

Замечания

Пример

WDFDEVICE                    Device;
NTSTATUS                     status;
PCODEC_RENDER_DEVICE_CONTEXT renderDevCtx = NULL;

// Code to initialize WDFDEVICE...

renderDevCtx = GetRenderDeviceContext(Device);

ASSERT(renderDevCtx->Circuit);
status = AcxDeviceDetachCircuit(Device, renderDevCtx->Circuit);

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

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

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

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

Требования

Требование	Ценность
заголовка	acxdevice.h
IRQL	PASSIVE_LEVEL

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