PEPCALLBACKNOTIFYDPM 回呼函式 (pepfx.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) 無法辨識的每個通知，拒絕處理 (。

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

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
目標平台 Windows
標頭 pepfx.h (包含 Pep_x.h)
IRQL <= DISPATCH_LEVEL

另請參閱

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx