EVT_ACX_FACTORY_CIRCUIT_POWER_UP回呼函式 (acxcircuit.h)

驅動程式會使用 EVT_ACX_FACTORY_CIRCUIT_POWER_UP 回呼，在 ACXFACTORYCIRCUIT 物件的電源啟動路徑中新增功能。

語法

EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;

NTSTATUS EvtAcxFactoryCircuitPowerUp(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE PreviousState
)
{...}

參數

Device

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

Factory

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

PreviousState

識別先前裝置電源狀態 的WDF_POWER_DEVICE_STATE列舉 。

傳回值

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

如果驅動程式失敗此回呼，它會將 ACXFACTORYCIRCUIT 標記為 pending-delete。 ACX 架構不會讓 ACX EvtDeviceD0Entry 回呼失敗，這可讓來自此裝置的現有運作 ACXFACTORYCIRCUIT 用來建置運作中的音訊路徑。

備註

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

如果驅動程式已註冊裝置的 EvtFactoryCircuitPowerUp 回呼函式，則架構會在每次裝置進入其運作 (D0) 狀態時呼叫函式。 當發生下列其中一項時，裝置會進入 D0 狀態：

• 裝置會列舉 (，因為裝置已插入或系統重新啟動) 。
• 系統及其所有裝置都會從低電源狀態返回其工作狀態。
• 如果裝置支援低電源閑置) ，則裝置進入低電源狀態之後會回到其運作狀態，因為裝置處於閑置狀態 (。
• 隨插即用 管理員已在系統裝置之間轉散發系統的硬體資源。
• 架構會在裝置進入其運作 (D0) 狀態后立即呼叫 EvtDeviceD0Entry 回呼函式，並可供驅動程式使用，但在裝置中斷啟用之前。 PreviousState 參數會識別裝置進入 D0 狀態之前所在的裝置電源狀態。 當架構第一次呼叫 EvtDeviceD0Entry 時，它會提供 WdfPowerDeviceD3Final 的 PreviousState 值。

此回呼函式必須執行讓裝置完全運作所需的任何作業。

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

EvtFactoryCircuitPowerUp 回呼函式是在 IRQL = PASSIVE_LEVEL呼叫。 您不應該讓此回呼函式可分頁。

ACX 需求

最小 ACX 版本： 1.0

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

規格需求

需求	值
標頭	acxcircuit.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxcircuit.h 標頭