IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
ドライバーの OnArmWakeFromSx イベント コールバック関数のアーム (つまり、有効) デバイスを使用して、低電力デバイスの状態でウェイク 信号をトリガーできるようにします。 スリープ解除信号により、デバイスは動作状態 (D0) に入り、システムはその動作状態 (S0) に入ります。
構文
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
パラメーター
[in] pWdfDevice
ドライバーのデバイスのいずれかを表すデバイス オブジェクトの IWDFDevice インターフェイスへのポインター。
戻り値
操作が成功した場合、OnArmWakeFromSx コールバック関数は、S_OKまたは SUCCEEDED(status) が TRUE 等しい別の状態値を返す必要があります。 それ以外の場合は、SUCCEEDED(status) が FALSE 等しい状態値を返す必要があります。
SUCCEEDED(status) が FALSE 等しい場合、フレームワークはドライバーの IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx コールバック関数を呼び出します。 (フレームワークは、PnP マネージャーにデバイスの障害を報告しません。
備考
ドライバーが IPowerPolicyCallbackWakeFromSx インターフェイスをサポートしている場合、ドライバーは OnArmWakeFromSx コールバック関数を提供する必要があります。
このコールバック関数は、デバイスがバスでウェイク シグナルをトリガーする外部イベントを検出できるようにするために必要なデバイス固有の操作を処理します。 カーネル モード バス ドライバーは、PCI バスの電源管理イベント (PME) 信号を有効にするなどのバス固有の操作を処理します。
ドライバーが OnArmWakeFromSx コールバック関数を登録している場合、デバイスがまだ D0 デバイスの電源状態である間、バス ドライバーがデバイスの電源状態を下げる前に、フレームワークがドライバーの代わりに 待機/ウェイク IRP を送信した後に、フレームワークによって呼び出されます。
このプロセスは、次の順序で実行されます。
- フレームワークは、システムが低電力システムの状態に入りようとしていることを判断します。
- フレームワークは、ドライバーの OnArmWakeFromSx コールバック関数を呼び出します。
- フレームワークは、デバイスの電源を下げるために、デバイスのバスをドライバーに要求します。
フレームワークがこのコールバック関数を呼び出すタイミングの詳細については、「UMDF の PnP と電源管理のシナリオをする」を参照してください。
デバイスがスリープ解除信号をトリガーできる特別なハードウェア操作を必要としない場合は、OnArmWakeFromSx コールバック関数を指定する必要はありません。
このコールバック関数の詳細については、「UMDF ベースのドライバー でシステム Wake-Up をサポートするを参照してください。
必要条件
要件 | 価値 |
---|---|
サポート終了 | UMDF 2.0 以降では使用できません。 |
ターゲット プラットフォーム の | デスクトップ |
UMDF の最小バージョン を する | 1.9 |
ヘッダー | wudfddi.h (Wudfddi.h を含む) |
関連項目
IPowerPolicyCallbackWakeFromSx の