SetHotpadNotification
This function enables hotpad notification. Applications which are to receive notification of hotpad events must call this function once to enable hotpad notification. A prototype of this function is shown below:
int SetHotpadNotification ( HWND WindowHandle, UINT MessageID )
Parameters this function accepts are described below:
Parameter | Description |
WindowHandle | Handle to the application window that will receive hotpad |
| notification messages. |
MessageID | Message ID of the notification message that will be sent to the |
| calling application window when a hotpad event occurs. |
Return values for SetHotpadNotification are as follows:
Return Value | Description |
Positive nonzero integer | Hotpad notification ID. Returned on success. |
| The library assigns a unique hotpad notification ID number for each |
| occurrence of the SetHotpadNotification function. Your application |
| must pass this ID number when hotpad notification is disabled |
| using the KillHotpadNotification function. |
0 | Memory allocation failure. |
WindowHandle parameter not valid. | |
Could not allocate system timer. |
KillHotpadNotification
This function disables hotpad notification for your application. Programs which have enabled hotpad notification should call this function before exiting or when hotpad notification is no longer desired. A prototype of this function is shown below:
BOOL KillHotpadNotification ( int NotificationID )
You must pass the hotpad notification ID number that was returned by SetHotpadNotification as the NotificationID parameter. Note that this function disables hotpad notification for the calling application only. Other applications which have enabled hotpad notification will continue to receive hotpad notification. Return values for this function are as follows:
Return Value | Description |
TRUE | Returned if the function is successful. Hotpad notification is |
| disabled. |
FALSE | Returned if the function fails. |
| This function will fail if the NotificationID parameter is not a valid |
| hotpad notification ID. |
SetHotpadNotification74