PC StandBy Detector for Java Apps

• Download source and demo files - 18.29 KB

Introduction

This article shows how your JAVA (and C++) program can detect and refuse sleep/stand-by/hibernate requests made by the user or the system.

Background

I wrote an application that is fed by a special PCI card, and runs 24/7. We found that if the PC went into standby mode, the PCI card was falsely activated, which was really bad. There was no easy way to uniformly disable the sleep/standby/hibernate features in Windows XP and therefore I decided to use the Windows API to detect if a standby request is made and refuse it. Luckily, the Win32 API has a message called WM_POWERBROADCAST that is sent to all applications when the PC wants to go into standby or hibernate mode. The win32 subsystem will abort the standby if you return BROADCAST_QUERY_DENY from this message handler.

By using this API, the enclosed code is able to detect if the computer goes into standby mode and through the utilization of JNI, notify the rest of the Java code about that event. Also, the code lets you allow or disallow the PC to enter standby mode.

Using the Code

To use the code from JAVA, simply instantiate a StandByDetector object and provide the constructor with a reference to a StandByRequestListener. The listener will be notified when a standby/hibernate request is made on the PC. Use the setAllowStandby() to tell the code if you want to allow entering a standby or not. Remember that the DLL (enclosed) has to be in your java.library.path path. Here is an example:

StandByDetector sd=new StandByDetector(new StandByRequestListener() {
    public void standByRequested() {
        System.out.println("standby requested");
    }
});
sd.setAllowStandby(false);

To compile and run the demo:

1. Extract the zip file contents into c:\temp preserving the zip dir structure.
2. Open cmd and cd into temp. Then issue on the command line:
   
   
   Java

   javac com\ha\common\windows\*.java 

3. Then, to run the demo, issue on the command line:
   
   
   Java

   java -Djava.library.path=C:\temp\com\ha\common\windows 
       -classpath c:\temp\com.ha.common.windows.StandByDetector 

4. Now try to put the PC in standby - Task manager -> Shut Down -> Stand By
5. You will note that the cmd shell shows the message "standby requested" and the PC does not go into standby.

History

• Initial version: 4-1-2004