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 コールバック関数を呼び出す前に、それを呼び出します。
システム ハードウェア (BIOSes、マザーボード、バス アダプター) は、信号がシステムを起動した場合でも、バス ドライバーが検出する前にスリープ解除信号をドロップすることがあります。 このような場合、ドライバーのデバイスがウェイク シグナルをトリガーした場合でも、ドライバーの EvtDeviceWakeFromSxTriggered コールバック関数は呼び出されません。
一部のバスは、いくつかの子供からのウェイク信号を組み合わせます。 デバイスがこれらのバスのいずれかに接続されている場合、コールバック関数は、現在のデバイスがウェイクアップ信号をトリガーしたかどうかを判断する必要がある場合があります。 デバイスがデバイスのトリガー状態を保存するハードウェア ラッチを提供する場合は、スリープ解除信号が削除された場合でも、そのコールバックは常にデバイスのスリープ解除後に呼び出されるため、ドライバーの EvtDeviceDisarmWakeFromSx コールバック関数でその状態をチェックすることをお勧めします。
このコールバック関数の詳細については、「 System Wake-Up のサポート」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfdevice.h (Wdf.h を含む) |
| IRQL | PASSIVE_LEVEL |