View source for WinGetPhysKeyState

This function returns the physical key state.

==Syntax==
 WinGetPhysKeyState(hwndDeskTop, sc)

==Parameters==
;hwndDeskTop (HWND) - input:Desktop-window handle.
::HWND_DESKTOP - The desktop-window handle
::Other - Specified desktop-window handle.
;sc (LONG) - input:Hardware scan code.
:Contains the scan code value in the low-order byte, and zero in the high-order byte.

==Returns==
;lKeyState (LONG) - returns:Key state.
:This value is the OR combination of the following bits:
::0x0001: The key has been pressed since the last time this function was issued, or since the system has been started if this is the first time the call has been issued.
::0x8000: The key is down.

==Errors==
Possible returns from WinGetLastError
;PMERR_INVALID_HWND (0x1001):An invalid window handle was specified.

==Remarks==
This function returns information about the asynchronous (interrupt level) state of the virtual key indicated by the sc parameter.

This function returns the physical state of the key; it is not synchronized to the processing of input (see the WinGetKeyState function).

==Example Code==
This example uses WinGetPhysKeyState to check the current state of the caps lock key; if it is depressed, a high pitch beep is emitted, while a low pitch beep is emitted if it is not depressed.
<pre>
#define INCL_WININPUT     /* Window Input functions */
#define INCL_DOSPROCESS   /* OS/2 Process functions */
#include <os2.h>

LONG   lKeyState;         /* Key state              */
LONG   lScancode;         /* Scan code value        */

/* Get the physical key state for the caps lock key */
lScancode = 0x3a;
lKeyState = WinGetPhysKeyState(HWND_DESKTOP, lScancode);

/* Emit the high-pitched beep if the caps lock is currently depressed; */
/* otherwise, emit a low-pitched beep                                  */
if (lKeyState & 0x8000)
   DosBeep(1000,100L);
else
   DosBeep(200,100L);
</pre>

== Related Functions ==
* WinEnablePhysInput
* WinFocusChange
* WinGetKeyState
* WinQueryFocus
* WinSetFocus
* WinSetKeyboardStateTable 

[[Category:Win]]