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

Статья
02/22/2024

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

Синтаксис

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Параметры

Device

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

Circuit

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

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

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

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

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

Remarks

Пример

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

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