PowerSettingRegisterNotification 関数 (powersetting.h)

  • [アーティクル]

電源設定が変更されたときに通知を受信するように登録します。

構文

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

パラメーター

[in] SettingGuid

電源設定を表す GUID。

[in] Flags

通知の受信者に関する情報。 このパラメーターには、次のいずれかの値を指定できます。

値 意味
DEVICE_NOTIFY_SERVICE_HANDLE
 Recipient パラメーターは、サービスへのハンドルです。 このハンドルを取得するには、 CreateService 関数または OpenService 関数を使用します。
DEVICE_NOTIFY_CALLBACK
 Recipient パラメーターは、電源設定が変更されたときに呼び出すコールバック関数へのポインターです。 この場合、受信者は PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS 型である必要があります。

[in] Recipient

通知の受信者へのハンドル。

[out] RegistrationHandle

登録のハンドル。 このハンドルを使用して、通知の登録を解除します。

戻り値

呼び出しが成功した場合ERROR_SUCCESS (ゼロ) を返し、呼び出しが失敗した場合は 0 以外の値を返します。

注釈

登録直後に、電源設定の現在の値を使用してコールバックが呼び出されます。 電源設定の変更中に登録が発生した場合は、複数のコールバックを受け取る可能性があります。最後のコールバックは最新の更新です。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー powersetting.h
Library Powrprof.lib
[DLL] Powrprof.dll

こちらもご覧ください

電源設定 GUID

PowerSettingUnregisterNotification