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
與 ACX 線路相關聯的 WDFDEVICE 物件（如 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） 狀態后立即呼叫 EvtDeviceD0Entry 回呼函式，並可供驅動程式使用，但在裝置中斷啟用之前。 PreviousState 參數會識別裝置進入 D0 狀態之前裝置電源狀態。 當架構第一次呼叫 EvtDeviceD0Entry 時，它會提供 WdfPowerDeviceD3Final 的 PreviousState 值。
此回呼函式必須執行讓裝置完全運作所需的任何作業。
如需提供此回呼函式之驅動程式的詳細資訊，請參閱函式驅動程式 中支援 PnP 和電源管理。
EvtFactoryCircuitPowerUp 回呼函式會在 IRQL = PASSIVE_LEVEL呼叫。 您不應該將此回呼函式設為可分頁。
ACX 需求
ACX 最低版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |