функция обратного вызова EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE (acxcircuit.h)

  • Статья

Обратный вызов EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE вызывается ACX, когда драйвер должен удалить ранее созданный объект WDFDEVICE, связанный с объектом ACXCIRCUIT.

Синтаксис

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

Параметры

Parent

Объект WDFDEVICE (описан в разделе Сводка по объектам платформы), который является родительским объектом WDFDEVICE, на который ссылается объект Device.

Factory

Существующий объект ACXFACTORYCIRCUIT фабрики цепи. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Device

Объект WDFDEVICE (описан в разделе Сводка объектов платформы), который необходимо удалить.

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

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

Комментарии

AcxFactoryCircuit представляет объект фабрики, способный создавать ACXCIRCUIT по запросу.

Драйвер может зарегистрировать один или несколько ACXFACTORYCIRCUIT в ACX. Это действие даст ACX знать, что драйвер способен создавать ACXCIRCUITs четко определенного типа.

ACX вызывает обратные вызовы ACXFACTORYCIRCUIT, когда обнаруживает, что для звукового пути требуется один из предоставленных фабрикой ACXCIRCUITs.

Это необязательный обратный вызов. Если обратный вызов EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE не определен, ACX выполняет действие по умолчанию, удалив указанный WDFDEVICE из списка перечисленных устройств. Это действие активирует уведомление о неожиданном удалении PnP дочернему объекту WDFDEVICE.

Объект ACXFACTORYCIRCUIT поддерживает динамические acXCIRCUITs. Это означает, что каждый объект ACXCIRCUIT, созданный фабрикой, связан с WDFDEVICE, и эти два объекта имеют одинаковое время существования.

AcxFactoryCircuit имеет выделенную очередь WDF. Дополнительные сведения об очередях WDF см. в разделе Объекты очередей платформы.

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

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

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

Требования

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

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