共用方式為


PEPCALLBACKNOTIFYDPM 回呼函式 (pep_x.h)

AcceptDeviceNotification 事件回呼例程會處理 Windows 電源管理架構 (PoFx) 的裝置電源管理 (DPM) 通知。

語法

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

BOOLEAN Pepcallbacknotifydpm(
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

參數

[in] Notification

DPM 通知標識碼。 此參數會指定 PoFx 正在傳送的 DPM 通知類型。 如需 DPM 通知識別碼的清單,請參閱 裝置電源管理 (DPM) 通知。

[in, out, optional] Data

PoFx 配置的結構的指標,其中包含此通知的輸入和輸出數據。 此結構的型別取決於 Notification所指定的通知標識符。 如需針對各種 DPM 通知識別碼定義的結構類型清單,請參閱 裝置電源管理 (DPM) 通知

傳回值

AcceptDeviceNotification 例程在處理通知時必須傳回 TRUE,否則傳回 FALSE。

言論

此例程是由裝置的平臺延伸模組外掛程式 (PEP) 所實作。 PEP_INFORMATION 結構 成員 AcceptDeviceNotification 是 AcceptDeviceNotification 例程的指標。 PEP 會呼叫 PoFxRegisterPluginPoFxRegisterPluginEx 例程,以向 PoFx 註冊 PEP 的 AcceptDeviceNotification 例程。

PoFx 會呼叫此例程,將 DPM 通知傳送至 PEP。 在此呼叫中,Notification 參數會指定通知的類型,而 Data 參數會指向與此通知相關聯的類型數據結構。 如需 DPM 通知識別碼及其相關聯的結構類型清單,請參閱 裝置電源管理 (DPM) 通知

DPM 通知會通知 PEP 各種系統、裝置或元件層級事件,或將要求從裝置驅動程式傳遞至 PEP。

AcceptDeviceNotification 例程不需要接受來自設備驅動器的每個要求,例如,它可以忽略閑置落地提示。 不過,PEP 必須瞭解並接受大部分裝置電源管理通知,即使 PEP 選擇不對其採取行動也一樣。 PEP 必須拒絕處理每個無法辨識的通知(傳回 FALSE)。

您可以在 IRQL <= DISPATCH_LEVEL 呼叫 AcceptDeviceNotification 例程。 呼叫 PEP AcceptAcpiNotification 例程的 IRQL 會根據傳送的通知類型而有所不同。 通知類型是由 Notification 參數所指定。 如需詳細資訊,請參閱 裝置電源管理 (DPM) 通知底下的個別參考頁面,

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始支援。
目標平臺 窗戶
標頭 pep_x.h (包括 Pep_x.h)
IRQL <= DISPATCH_LEVEL

另請參閱

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx