PowerRegisterSuspendResumeNotification 関数 (powerbase.h)

  • [アーティクル]

システムが中断または再開されたときに通知を受信するように登録します。

構文

DWORD PowerRegisterSuspendResumeNotification(
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

パラメーター

[in] Flags

このパラメーターは DEVICE_NOTIFY_CALLBACKする必要があります。

[in] Recipient

このパラメーターは、 DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS 構造体へのポインターです。 この場合、コールバック関数は DeviceNotifyCallbackRoutine です。 Callback 関数を実行すると、発生したイベントの種類を示す Type パラメーターが設定されます。 使用可能な値には、 PBT_APMSUSPEND、 PBT_APMRESUMESUSPEND、 PBT_APMRESUMEAUTOMATIC が含まれます。詳細については、「 Power Management イベント 」を参照してください。 Setting パラメーターは、中断/再開通知では使用されません。

[out] RegistrationHandle

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

戻り値

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

要件

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

関連項目

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

PowerUnregisterSuspendResumeNotification