EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED回呼函式 (wdfdevice.h)

發行項
02/29/2024

[適用於 KMDF 和 UMDF]

驅動程式的 EvtDeviceWakeFromS0Triggered 事件回呼函式會通知驅動程式，其裝置先前已進入低電源裝置狀態，而系統電源狀態維持在 S0 時，可能會觸發喚醒訊號。

語法

EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;

void EvtWdfDeviceWakeFromS0Triggered(
  [in] WDFDEVICE Device
)
{...}

參數

[in] Device

架構裝置物件的句柄。

傳回值

無

備註

若要註冊 EvtDeviceWakeFromS0Triggered 回 呼函式，驅動程式必須呼叫 WdfDeviceInitSetPowerPolicyEventCallbacks。

如果驅動程式已註冊此回呼，架構會在呼叫驅動程式的 EvtDeviceD0Entry 回呼函式，並在呼叫驅動程式的 EvtDeviceDisarmWakeFromS0 回呼函式之前呼叫它。

系統硬體 (BIOSes、主機板、總線適配卡) 有時會在總線驅動程式偵測到它之前卸除喚醒訊號，即使訊號喚醒系統也一樣。在這種情況下，即使驅動程式的裝置觸發喚醒訊號，驅動程式的 EvtDeviceWakeFromS0Triggered 回呼函式也不會呼叫。

有些公交車結合了來自數個子系的喚醒訊號。如果您的裝置已連線到其中一個總線，回呼函式可能必須判斷目前的裝置是否觸發喚醒訊號。如果您的裝置提供可儲存裝置觸發狀態的硬體閂鎖，最好檢查驅動程式的EvtDeviceDisarmWakeFromS0 回呼函式中的該狀態，因為該回呼一律會在裝置喚醒後呼叫，即使已捨棄喚醒訊號也一樣。

如需此回呼函式的詳細資訊，請參閱支援閑置電源關閉。