System Events Database
The DB_notify_register database stores system event notifications. The following table shows the fields in the DB_notify_register database.
| Field name | Description |
|---|---|
| PROPIDR_NAME | Stores the application name. |
| PROPIDR_CMDLINE | Store the parameters associated with the application. |
| PROPIDR_EVENT | Specifies the event trigger. |
Windows CE defines the following system event triggers:
- NOTIFICATION_EVENT_TIME_CHANGE
- NOTIFICATION_EVENT_SYNC_END
- NOTIFICATION_EVENT_ON_AC_POWER
- NOTIFICATION_EVENT_OFF_AC_POWER
- NOTIFICATION_EVENT_NET_CONNECT
- NOTIFICATION_EVENT_NET_DISCONNECT
- NOTIFICATION_EVENT_DEVICE_CHANGE
- NOTIFICATION_EVENT_IR_DISCOVERED
- NOTIFICATION_EVENT_RS232_DETECTED
- NOTIFICATION_EVENT_RESTORE_END
- NOTIFICATION_EVENT_WAKEUP
- NOTIFICATION_EVENT_TZ_CHANGE
Although these triggers are defined by the system, it is your responsibility to implement each of these triggers respective to hardware. The system ignores any settings that are not on the current device. You can also define custom triggers.
The base notification engine exposes some interfaces that the notification UI uses to deliver user responses to notifications. The following table shows these functions.
| Function | Description |
|---|---|
| CeNotifyPrivate_Lock | Locks the notification database. The database should not be locked for extended periods of time because notification application programming interface (API) calls are blocked while the database is locked. The integrity of NotifyPacket structures is guaranteed only when the database is locked. |
| CeNotifyPrivate_Unlock | Unlocks the notification database. |
| CeNotifyPrivate_TranslateOID | Translates a specified object identifier to a NotifyPacket structure pointer. This function can return NULL if the notification has already been handled. |
| CeNotifyPrivate_Reschedule | Reschedules a notification. |
| CeNotifyPrivate_DeleteNotification | Deletes a notification that has been handled. |
| CeNotifyPrivate_SetUserAlarm | Sets a user alarm. |
| CeNotifyPrivate_ClearUserAlarm | Clears a user alarm. |
| CeNotifyPrivate_FilterType | Filters packet types with a specified value for all active notifications. You can use this function to switch off active audio notification bits. |
See Also
Using the Base Notification Engine
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.