EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED コールバック関数 (wdfdevice.h)

[KMDF と UMDF に適用]

ドライバーの EvtDeviceWakeFromS0Triggered イベント コールバック関数は、システムの電源状態が S0 のままで、以前に低電力デバイス状態に入っていたデバイスがスリープ解除信号をトリガーした可能性があることをドライバーに通知します。

構文

EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;

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

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

戻り値

何一つ

備考

EvtDeviceWakeFromS0Triggered コールバック関数を登録するには、ドライバーが WdfDeviceInitSetPowerPolicyEventCallbacksを呼び出す必要があります。

ドライバーがこのコールバックを登録している場合、フレームワークは、ドライバーの EvtDeviceD0Entry コールバック関数を呼び出した後、およびドライバーの EvtDeviceDisarmWakeFromS0 コールバック関数を呼び出す前に呼び出します。

システム ハードウェア (BIOS、マザーボード、バス アダプター) は、信号がシステムをウェイクアップした場合でも、バス ドライバーが検出する前にウェイク 信号をドロップすることがあります。 このような場合、ドライバーのデバイスがウェイク シグナルをトリガーした場合でも、ドライバーの EvtDeviceWakeFromS0Triggered コールバック関数は呼び出されません。

一部のバスは、複数の子からのウェイク信号を組み合わせたものがあります。 デバイスがこれらのバスのいずれかに接続されている場合、コールバック関数は、現在のデバイスがウェイクアップ信号をトリガーしたかどうかを判断する必要があります。 デバイスがデバイスのトリガーされた状態を保存するハードウェア ラッチを提供する場合は、ドライバーの EvtDeviceDisarmWakeFromS0 コールバック関数でその状態を確認することをお勧めします。これは、スリープ解除信号が破棄された場合でも、デバイスのスリープ解除後にコールバックが常に呼び出されるためです。

このコールバック関数の詳細については、「アイドル状態の電源ダウン をサポートを参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	wdfdevice.h (Wdf.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

EvtDeviceArmWakeFromS0 の

EvtDeviceDisarmWakeFromS0 の

EvtDeviceWakeFromSxTriggered の