EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE回呼函式 (acxcircuit.h)

  • 發行項

當 ACXFACTORYCIRCUIT 處於發行硬體階段時，驅動程式會使用 EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE 回呼來新增功能。

語法

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EvtAcxFactoryCircuitReleaseHardware;

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

參數

Device

WDFDEVICE 物件 (描述於與 ACX 線路相關聯的 Framework 物件 摘要) 。

Factory

現有的線路處理站 ACXFACTORYCIRCUIT 物件。 (如需 ACX 物件的詳細資訊，請參閱 ACX 物件的摘要。

ResourcesTranslated

WDF 資源清單，描述要用於準備硬體階段的已翻譯資源。 這是WDF架構資源清單物件，代表裝置的硬體資源清單。 如需翻譯資源清單的詳細資訊，請參閱 原始和翻譯的資源。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

若要註冊 EvtAcxFactoryCircuitReleaseHardware 回呼函式，您的驅動程式必須呼叫 AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks。

如果驅動程式已註冊 EvtAcxFactoryCircuitReleaseHardware 回呼函式，架構會在下列轉換期間呼叫它：

  • 資源重新平衡
  • 依序移除
  • 意外移除

ACX 架構會在 WDF 架構停止傳送 I/O 要求給裝置之後，呼叫 EvtAcxFactoryCircuitReleaseHardware 回呼函式、已停用和中斷指派給裝置的任何中斷，以及裝置已關閉。

ACX 架構會在 WDF 架構呼叫驅動程式的 EvtDeviceReleaseHardware 回呼函式之前，先呼叫 EvtAcxFactoryCircuitReleaseHardware 回呼函式。

當架構呼叫 EvtAcxFactoryCircuitReleaseHardware 裝置的 PDO 仍然存在，而且可以查詢處於關閉電源狀態的裝置資訊，例如 PCI 設定狀態。

此外，架構提供給 EvtDeviceReleaseHardware 的已翻譯硬體資源仍會指派給裝置。 此回呼函式的主要目的是釋放這些資源，特別是取消對應驅動程式 EvtAcxCircuitPrepareHardware 回呼函式所對應的任何記憶體資源。 驅動程式也可以使用此回呼來執行任何其他可能處於關機狀態的 ACXCIRCUIT 管理活動。 通常，所有其他硬體關機作業都應該在驅動程式的 EvtDeviceD0Exit 回呼函式中執行。

如果已呼叫驅動程式的 EvtAcxFactoryCircuitReleaseHardware 回呼函式，ACX 架構一律會呼叫驅動程式的 EvtAcxFactoryCircuitPrepareHardware 回呼函式，除非 EvtAcxFactoryCircuitPrepareHardware 傳回失敗碼。

如需 ACX 和 WDF 架構何時呼叫這些回呼函式的詳細資訊，請參閱 PnP 和電源管理案例。

如需硬體資源的詳細資訊，請參閱 硬體資源簡介。

如需提供此回呼函式之驅動程式的詳細資訊，請參閱 支援函式驅動程式中的 PnP 和電源管理。

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求 值
標頭 acxcircuit.h
IRQL PASSIVE_LEVEL

另請參閱