функция обратного вызова 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 |