Omron 3G8F7-CRM21, User Manual

Page: 119 / 238

99
Board Request Notification API Section A-8
A-8-3 CPNT_RegRESETNotifyMessage (Register Board Reset Request
Message)
Purpose Register the Windows message to request a Board reset.
Call Format BOOL CPNT_RegRESETNotifyMessage (
HANDLE Handle,
DWORD ThreadId,
HWND hWnd,
UINT Msg
) ;
Argument
Returned value It returns TRUE when the message has been successfully registered.
It returns FALSE when both the thread ID and the window handle are null or
when an error occurs. Detailed error content can be obtained with
GetLastError( ).
Remarks
•
A Board reset request is generated by sending a reset service to the Identity
object on the CompoNet Master Board.
•
See Section 4-5 for Board rest requests.
•
The value 0 is stored in both of WPARAM and LPARAM of the notified
message.
•
Set either the thread ID or the window handle. If both are set, an error will be
returned and the message will not be registered.
A-8-4 CPNT_UnRegRESETNotifyMessage (Unregister Board Reset
Request Message)
Purpose Unregister the Windows message to request a Board reset.
Call Format BOOL CPNT_UnRegRESETNotifyMessage (HANDLE Handle) ;
Argument
Returned value It returns TRUE when the function succeeds.
It returns FALSE when an error occurs. The error details can be obtained with
the function GetLastError.
Remarks It returns TRUE when the message has been successfully unregistered.
It returns FALSE when an error occurs.
Detailed error content can be obtained with GetLastError( ).
Type Parameter Direction Description
HANDLE Handle IN Device handle obtained with the
function CPNT_Open
DWORD ThreadId IN ID of the thread to notify
(No setting: NULL)
HWND hWNd IN Window handle to notify
(No setting: NULL)
UINT Msg IN Notification message (Event ID)
Type Parameter Direction Description
HANDLE Handle IN Device handle obtained with the
function CPNT_Open