![background image](http://html.mh-extra.com/html/omron/devicenet-3g8f7-drm21-e/devicenet-3g8f7-drm21-e_operation-manual_743611098.webp)
81
Explicit Message API Functions
Section 4-6
Arguments
Return Value
TRUE is returned when the message monitoring timer list was successfully
loaded from non-volatile memory. FALSE is returned if an error occurred.
Detailed error information can be read with the GetLastError() function.
Description
The message monitoring timer values for all node addresses are refreshed
using the saved values.
If this function is used without SCAN_StoreMessageTimerValueList() being
executed, the default value, 0 (2 s), will be used as the message monitoring
timer value for all node addresses.
4-6-2
Client Message Service API Functions
Registering a Client Response Message: SCAN_RegClientEvtNotifyMessage()
Application Range
Open status
Function
Registers the Windows message sent when a client response reception event
occurs from the specified node address.
Call Format
BOOL SCAN_RegClientEvtNotifyMessage(DWORD
Handle
, WORD
MacId
,
DWORD
ThreadId
, HWND
hWnd
, UINT
Msg
)
Arguments
Return Value
TRUE is returned if the message registration was completed successfully.
FALSE is returned if an error occurred such as null values for both the thread
ID and window handle. Detailed error information can be read with the Get-
LastError() function.
Description
The client response source (remote) node address is sent to WPARAM with
the notification message. The reception response size (in bytes) is sent to
LPARAM with the notification message.
Clearing a Client Response Message: SCAN_UnRegClientEvtNotifyMessage()
Application Range
Open status
Function
Clears the registered notification message of the specified node address.
Call Format
BOOL SCAN_UnRegClientEvtNotifyMessage(DWORD
Handle
, WORD
MacId
)
Type
Name
Contents
DWORD
Handle
Device handle obtained by SCAN_Open()
Type
Name
Contents
DWORD
Handle
Device handle obtained by SCAN_Open()
WORD
MacId
Node address to check for events
Setting range: 0x00 to 0x3F (0 to 63)
DWORD
ThreadId
The thread ID to notify.
(No setting = NULL)
HWND
HWnd
Specifies the window handle to notify.
(No setting = NULL)
UINT
Msg
Notification message (event ID)
Range: W 0x100 to W 0x7FFF
Summary of Contents for DeviceNet 3G8F7-DRM21-E
Page 1: ...OPERATION MANUAL Cat No W381 E1 02 3G8F7 DRM21 E DeviceNet PCI Board ...
Page 2: ...3G8F7 DRM21 E DeviceNet PCI Board Operation Manual Revised July 2005 ...
Page 3: ...iv ...
Page 5: ...vi ...
Page 29: ...12 Preparation for Operation Section 1 8 ...
Page 67: ...50 PC Watchdog Timer Management Function Section 3 11 ...
Page 115: ...98 Maintenance API Functions Section 4 7 ...
Page 131: ...114 Remote I O Communications Characteristics Section 6 1 ...
Page 145: ...Index 128 ...
Page 147: ...130 Revision History ...