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

Статья
01/07/2025

Функция AcxDeviceRemoveFactoryCircuit удаляет канал фабрики для создания звуковых каналов из WDFDEVICE.

Синтаксис

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Параметры

Device

WDFDEVICE, из которого будет удален канал фабрики ACX.

Factory

Канал фабрики ACX для удаления из WDFDEVICE, указанный параметром устройства .

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

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

Замечания

Типичный драйвер не должен вызывать AcxDeviceRemoveFactoryCircuit. Эта функция не должна вызываться, если канал фабрики создал устройства канала, которые по-прежнему активны.

Если драйвер решит вызвать эту функцию для канала фабрики, драйвер становится ответственным за первое удаление устройств цепи, созданных с помощью связанного канала фабрики, перед вызовомAcxDeviceRemoveFactoryCircuit.

Дополнительные сведения о работе с каналами см. в динамическом удалении каналов ACX и перечислении устройств ACX.

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

Используйте AcxDeviceAddFactoryCircuit, чтобы добавить канал фабрики в WDFDEVICE.

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

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

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

Требования

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

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