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

[KMDF と UMDF に適用]

ドライバーの EvtDeviceWakeFromSxTriggered イベント コールバック関数は、システム電源が低下したために低電力デバイスの状態に入っていたデバイスがウェイク シグナルをトリガーした可能性があることをドライバーに通知します。

構文

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

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

パラメーター

[in] Device

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

戻り値

何一つ

備考

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

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

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

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

このコールバック関数の詳細については、「システム ウェイクアップ のサポートを参照してください。

必要条件

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

関連項目

EvtDeviceArmWakeFromSx の

EvtDeviceDisarmWakeFromSx の

EvtDeviceWakeFromS0Triggered の