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

Обратный вызов EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE используется драйвером для добавления функций, когда ACXFACTORYCIRCUIT находится на этапе выпуска оборудования.

Синтаксис

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EvtAcxFactoryCircuitReleaseHardware;

NTSTATUS EvtAcxFactoryCircuitReleaseHardware(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDFCMRESLIST ResourcesTranslated
)
{...}

Параметры

Device

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

Factory

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

ResourcesTranslated

Список ресурсов WDF, описывающий преобразованные ресурсы, которые будут использоваться для этапа подготовки оборудования. Это объект списка ресурсов платформы WDF, представляющий список аппаратных ресурсов для устройства. Дополнительные сведения о переведенных списках ресурсов см. в необработанных и переведенных ресурсов.

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

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

Замечания

Чтобы зарегистрировать функцию обратного вызова EvtAcxFactoryCircuitReleaseHardware, драйвер должен вызвать AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.

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

• Перебалансирование ресурсов
• Упорядочение удаления
• Удаление сюрпризов

Платформа ACX вызывает функцию обратного вызова EvtAcxFactoryCircuitReleaseHardware после того, как платформа WDF перестала отправлять запросы ввода-вывода на устройство, все прерывания, назначенные устройству, были отключены и отключены, а устройство отключено.

Платформа ACX вызывает функцию обратного вызова EvtAcxFactoryCircuitReleaseHardware, прежде чем платформа WDF вызывает функцию обратного вызова EvtDeviceReleaseHardware драйвера.

Когда платформа вызывает EvtAcxFactoryCircuitReleaseHardware PDO для устройства по-прежнему существует и может запрашиваться сведения об устройстве, доступные в состоянии выключенного питания, например состояние конфигурации PCI.

Кроме того, преобразованные аппаратные ресурсы, предоставляемые платформой evtDeviceReleaseHardware, по-прежнему назначаются устройству. Основная цель этой функции обратного вызова — освободить эти ресурсы и, в частности, отменить сопоставление ресурсов памяти, сопоставленных функцией обратного вызова EvtAcxCircuitPrepareHardware. Драйвер также может использовать этот обратный вызов для выполнения любых других действий управления ACXCIRCUIT, которые могут потребоваться в состоянии выключенного питания. Обычно все остальные операции завершения работы оборудования должны выполняться в функции обратного вызова EvtDeviceD0Exit драйвера.

Платформа ACX всегда вызывает функцию обратного вызова EvtAcxFactoryCircuitReleaseHardware, если функция обратного вызова EvtAcxFactoryCircuitPrepareHardware была вызвана, если не был вызван код сбоя EvtAcxFactoryCircuitPrepareHardware.

Дополнительные сведения о том, когда платформа ACX и WDF вызывают эти функции обратного вызова, см. в сценариях управления питанием и PnP.

Дополнительные сведения об аппаратных ресурсах см. в статье Введение в аппаратные ресурсы.

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

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

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

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

Требования

См. также

• заголовка acxcircuit.h