home *** CD-ROM | disk | FTP | other *** search
/ Team Palmtops 7 / Palmtops_numero07.iso / WinCE / SDKWindowsCE / AutoPC / apcsdk10.exe / data1.cab / Emulation_Include_Files / apcmsg.h < prev    next >
Encoding:
C/C++ Source or Header  |  1999-05-13  |  7.8 KB  |  246 lines
  1. /*++
  2.  
  3. Copyright (c) 1998  Microsoft Corporation
  4.  
  5. Module Name: ApcMsg.h
  6.  
  7. Purpose: Master message include for AutoPC specific messages
  8.  
  9. --*/
  10.  
  11. #ifndef _APCMSG_H_
  12. #define _APCMSG_H_
  13.  
  14. /*++
  15.  
  16.     Application Notes for AutoPC developers
  17.     =======================================
  18.  
  19.     When programming for the Microsoft AutoPC platform based on Windows CE
  20.     application developers must not use the message range 0xB000 through
  21.     0xBFFF.  This range is reserved in its entirety for AutoPC specific
  22.     messages.  This range is part of the WM_APP range in desktop Win32
  23.     platforms.
  24.     
  25.     Messages that are private to a window class may be defined in the WM_USER
  26.     range (0x0400 through 0x7FFF inclusive).
  27.     
  28.     Messages which are private to an application may be defined in the lower
  29.     part of the WM_APP range (0x8000 through 0xAFFF inclusive).
  30.     
  31.     Messages that are to be shared between applications or processes must be
  32.     defined using the RegisterWindowMessage() API.
  33.  
  34. --*/
  35.  
  36. #define APC_MSG_START   0xB000
  37.  
  38. // 0x000 - 0xCFF - 3328 messages available
  39.  
  40. #define APC_SYS_START   (APC_MSG_START + 0xD00)     // 256 system messages
  41. #define APC_SYS_END     (APC_MSG_START + 0xDFF)
  42.  
  43. // 0xE00 - 0xE2F - 48 messages available
  44.  
  45. #define APC_CPL_START   (APC_MSG_START + 0xE30)     // 16 control pannel messages
  46. #define APC_CPL_END     (APC_MSG_START + 0xE3F)
  47.  
  48. #define APC_IR_START    (APC_MSG_START + 0xE40)     // 16 Infrared messages
  49. #define APC_IR_END      (APC_MSG_START + 0xE4F)
  50.  
  51. #define APC_COMM_START  (APC_MSG_START + 0xE50)     // 16 Comm related messages
  52. #define APC_COMM_END    (APC_MSG_START + 0xE5F)
  53.  
  54. // e60 - e7f unsued
  55.  
  56. #define APC_SPCH_START  (APC_MSG_START + 0xE80)     // 64 Speech messages
  57. #define APC_SPCH_END    (APC_MSG_START + 0xEBF)
  58.  
  59. #define APC_AUD_START   (APC_MSG_START + 0xEC0)     // 64 Audio messages
  60. #define APC_AUD_END     (APC_MSG_START + 0xEFF)
  61.  
  62. #define APC_FRM_START   (APC_MSG_START + 0xF00)     // 256 Forms Manager messages
  63. #define APC_FRM_END     (APC_MSG_START + 0xFFF)
  64.  
  65. #define APC_MSG_END     (APC_MSG_START + 0xFFF)
  66.  
  67.  
  68. /*++
  69.     AutoPC Settings changed Notifications
  70.     =======================================
  71.  
  72.     The AutoPC provides several system components that are extensions to the
  73.     core WinCE system. The configuration settings for these components are 
  74.     set and read through the AutoPC APIs specific to each individual subsystem. 
  75.     When the Control Panel modifies an APC system setting which necessitates a 
  76.     notification for running applications it will broadcast a WM_SETTINGCHANGE
  77.     message to all running applications.
  78.     The wParam for the APC specific notifications will be one of the values 
  79.     defined here. The AutoPC specific SPI_SETAPCXXXX values posted in the 
  80.     WM_SETTINGCHANGE notification message will are not valid to pass to the 
  81.     core WinCE SystemParametersInfo API. An application which needs to take 
  82.     action on an APC setting change should check for the WM_SETTINGCHANGE 
  83.     message on the application message sink and then call the appropriate 
  84.     subsystem API directly to retrieve the new value for the setting.
  85.     The lParam posted with an APC system WM_SETTINGCHANGE will always be NULL
  86.     
  87. --*/
  88.  
  89. #define SPI_SETAPCSHELL         0x000100100
  90. #define SPI_SETAPCSCREENSAVER   0x000100102
  91. #define SPI_SETAPCAUDIO         0x000100104
  92. #define SPI_SETAPCLOCALE        0x000100106
  93. #define SPI_SETAPCFEEDBACK      0x000100108
  94. #define SPI_SETAPCGLOBALGRAMMAR 0x00010010a
  95.  
  96. /*++
  97.     AutoPC Broadcast notification messges
  98.     =======================================
  99.  
  100. --*/
  101.  
  102. /*++
  103.     WM_APCSYSMSG_MEDIASTATECHANGE
  104.     =============================
  105. --*/
  106.  
  107. #define     WM_APCSYSMSG_MEDIASTATECHANGE           (APC_SYS_START + 4)
  108.  
  109. // Media type - Passed in HIWORD of wParam
  110.  
  111. #define     APC_MEDIATYPE_CD            1
  112.  
  113. // Notification flags - Passed in LOWORD of wParam
  114.  
  115. #define     APC_FLG_MEDIAINSERT         0x0001
  116. #define     APC_FLG_MEDIAHASAUDIO       0x0010
  117. #define     APC_FLG_MEDIAHASDATA        0x0020
  118. #define     APC_FLG_MEDIAUNKNOWN        0x0040
  119. #define        APC_FLG_MEDIAUNDETERMINED    0x0080
  120.  
  121. // Device generating notification, passed in HIWORD of lParam. The device id
  122. // passed is the AAM audio source of the device defined in apcaudio.h
  123.  
  124. // AAM_SRC_CD                      
  125. // AAM_SRC_CDCHANGER               
  126.  
  127. // Device specific information passed in LOWORD of lParam
  128.  
  129. /*++
  130.     WM_APCSYSMSG_VOLUMECHANGED
  131.     ==========================
  132.  
  133.     wParam - Rsvd.
  134.     lParam - Rsvd.
  135.     
  136.     This message currently takes no parameters. It is sent when the audio
  137.     volume changes.
  138. --*/
  139.  
  140. #define        WM_APCSYSMSG_VOLUMECHANGED                (APC_SYS_START + 5)
  141.  
  142. /*++
  143.     WM_APCSYSMSG_MUTE
  144.     =================
  145.  
  146.     wParam - Rsvd
  147.     lParam - TRUE if the audio state is changed to be muted
  148. --*/
  149.  
  150. #define        WM_APCSYSMSG_MUTE                        (APC_SYS_START + 6)    
  151.  
  152. /*++
  153.     WM_APCSYSMSG_POWERSTATECHANGE
  154.     =============================
  155.  
  156.     wParam - Power Notification type
  157.     lParam - TRUE if the power state is changed to ON
  158.            - FALSE if the power state is changed to OFF 
  159.  
  160.     Note -  a APC_PWRNOTIFYTYPE_ELECTRICAL notificaltion is not sent when the 
  161.             electrical power is removed, Only when it is restored
  162.            
  163. --*/
  164.  
  165. #define        WM_APCSYSMSG_POWERSTATECHANGE            (APC_SYS_START + 7)
  166.  
  167. // wParam
  168. #define APC_PWRNOTIFYTYPE_USER                  1
  169. #define APC_PWRNOTIFYTYPE_ELECTRICAL            2
  170. #define APC_PWRNOTIFYTYPE_BACKUPBATTERY_LOW        3    // lParam: HIWORD: 1-good 0-lowbattery, LOWORD: Battery index (zero based)
  171.  
  172. /*++
  173.     WM_APCSYSMSG_BACKUPNOTIFY
  174.     =============================
  175.  
  176.     wParam - Thread Id of the backup.exe main thread (received by app)
  177.            - 0 when posted to backup.exe (posted by app)
  178.     lParam - Backup transaction id
  179.  
  180.     Note -  The backup.exe broadcasts this message at the beginning of the
  181.             backup operation.  Applications should flush their data to the
  182.             registry/file-system/object store upon receiving this message
  183.             to ensure that it will be preserved by the backup operation.
  184.             Applications have 5 seconds after the issuance of this message
  185.             to complete their save operations. Any application may request
  186.             more time in units of 5 seconds by posting the backup thread
  187.             this message with the wParam=0, lParam=Backup transaction id.
  188. --*/
  189. #define        WM_APCSYSMSG_BACKUPNOTIFY                (APC_SYS_START + 8)
  190.  
  191.  
  192. /*++
  193.     WM_APCSYSMSG_INSTALLNOTIFY
  194.     =============================
  195.  
  196.     wParam - 0
  197.     lParam - 0
  198.     
  199.     Note -  The ApcLoad.exe broadcasts this message at the beginning of the
  200.             install operation.  Well behaved applications should exit in
  201.             response to this message, treating it like a WM_CLOSE.
  202.             Applications have 5 seconds after the issuance of this message
  203.             to complete their shutdown operations. 
  204. --*/
  205. #define        WM_APCSYSMSG_INSTALLNOTIFY                (APC_SYS_START + 9)
  206.  
  207.  
  208. /*++
  209.     WM_APCSYSMSG_ASSISTEVENT
  210.     =============================
  211.  
  212.     Broadcast by an OEM installed driver when an Assist level event occurs.
  213.     
  214.     wParam - HIWORD Severity level
  215.     wParam - LOWORD Rsvd
  216.     lParam - Rsvd
  217. --*/
  218.  
  219. #define        WM_APCSYSMSG_ASSISTEVENT                (APC_SYS_START + 10)
  220.  
  221. // Current defines for HIWORD( wParam)
  222.  
  223. #define     APC_ASSISTSEVERITY_CRITICAL             1
  224. #define     APC_ASSISTSEVERITY_USER                 2
  225.  
  226. //=====================================================================
  227. // APC Communications messages
  228.  
  229. /*++
  230.     WM_APCCOMM_DIALSTATECHANGED
  231.     =================
  232.  
  233.     Broadcast by internal TAPI Thread through app sink to ABAPI forms
  234.  
  235.     wParam - New dialing state
  236.     lParam - Previous state result
  237. --*/
  238.  
  239. #define        WM_APCCOMM_DIALSTATECHANGED            (APC_COMM_START + 0)    
  240.  
  241.  
  242.  
  243.  
  244. #endif // _APCMSG_H_
  245.  
  246.