在 UMDF 驅動程式中支援系統Wake-Up

警告

UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。

封存的 UMDF 1 範例可在Windows 11 22H2 版 - 2022 年 5 月驅動程式範例更新中找到。

如需詳細資訊，請參閱使用 UMDF 消費者入門。

當系統處於低電源狀態時，某些裝置可以偵測外來事件，例如傳入的網路封包，然後喚醒系統。 例如，如果 PCI 裝置具有系統喚醒功能，如裝置的電源管理功能 (PMC) 註冊所示，它會在 PCI 匯流排上引發電源管理事件 (PME) 訊號來喚醒系統。

如果您的裝置可以從全系統的低電源狀態喚醒系統，電源原則擁有者中的IDriverEntry：：OnDeviceAdd回呼函式必須執行下列兩個步驟：

1. 呼叫 IWDFDevice2：：AssignSxWakeSettings 以指定：

   • 裝置將進入的低電源狀態
   • 使用者是否可以控制裝置的閒置設定
   • 裝置的喚醒功能是否已啟用或停用

2. 如果您需要裝置的介面，請實作 IPowerPolicyCallbackWakeFromSx 介面和下列事件回呼函式：

   • IPowerPolicyCallbackWakeFromSx：：OnArmWakeFromSx，可讓裝置硬體回應外部喚醒事件。
   • IPowerPolicyCallbackWakeFromSx：：OnDisarmWakeFromSx，這會停用裝置回應外部喚醒事件的能力。
   • IPowerPolicyCallbackWakeFromSx：：OnWakeFromSxTriggered，通知驅動程式匯流排偵測到喚醒訊號。

匯流排驅動程式也會參與喚醒系統。 裝置匯流排的核心模式驅動程式會在匯流排介面卡上執行任何必要動作，以啟用和停用裝置從低電源狀態喚醒的能力。

如需控制裝置喚醒功能的登錄專案相關資訊，請參閱 UMDF 中的裝置閒置和喚醒行為的使用者控制。