PEPCALLBACKNOTIFYDPM 回呼函式 (pep_x.h)

  • 發行項

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

語法

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 會呼叫 PoFxRegisterPlugin 或 PoFxRegisterPluginEx 例程，以向 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 開始支援。
目標平台 Windows
標頭 pep_x.h (包含 Pep_x.h)
IRQL <= DISPATCH_LEVEL

另請參閱

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx