57
Library Functions
Section 4-1
Supplemental Information
The unit address is different from the board ID on the Support Board.
It is not normally necessary to specify a unit address when sending a com-
mand from an application running on the computer and receiving a response.
Always specify the unit address when sending a command to the application
from an application running on a computer or from a PC at a different node.
4-1-2
ClkClose()
Board Close
Function
Opens the application interface and gets a CLK handle.
Call Format
INT ClkClose(PCLKHANDLE hCLK);
Return Value
CLK_SUCCESS is returned if the function ends normally.
CLK_ERROR is returned if the function ends in an error. Detailed error infor-
mation can be obtained using ClkGetLastError().
Description
If the application is ended without using ClkClose(), the address specified for
ClkOpen() cannot be used again. Always execute ClkClose() for all CLK han-
dles obtained with ClkOpen() before ending the application.
4-1-3
ClkSendFins()
FINS Message Send
Function
Sends a FINS message.
Call Format
INT ClkSendFins(PCLKHANDLE hCLK, PCLKHEADER pHeader, LPVOID
lpMessage, DWORD dwSize);
Return Value
CLK_SUCCESS is returned if the function ends normally.
CLK_ERROR is returned if the function ends in an error. Detailed error infor-
mation can be obtained using ClkGetLastError().
Description
Refer to
Structure Descriptions
for information on the header information
structure.
Store the FINS message from the command code (MRC) on in the FINS mes-
sage send buffer.
The amount of data that can be sent and received will be limited by the type of
networks through which the message must pass. The largest value that the
send buffer (dwSize) can be set to is 1,998 bytes. The limit when passing
through a SYSMAC LINK Network is 542 bytes.
If SID is –1, autoincrementing will be used for the SID. (There is only one SID
memory area for each process when automatically incrementing functions
internally. There are not separate areas for each network handle or thread.)
The function will end in an error if a FINS message send buffer size of less
than 2 bytes is specified in the argument. (Detailed error information =
ERR_SEND_BUFFER_SIZE: Send message size error)
Type
Variable name
Description
PCLKHANDLE
hCLK
The CLK handle obtained with ClkO-
pen()
Arguments
Type
Variable name
Description
PCLKHANDLE
hCLK
The CLK handle obtained with ClkO-
pen()
PCLKHEADER
pHeader
Pointer to the header information struc-
ture for the FINS message
LPVOID
lpMessage
Pointer to the send buffer for the FINS
message
DWORD
dwSize
Size of FINS message send buffer
Arguments
Summary of Contents for SYSMAC 3G8F7-CLK12-EV1
Page 2: ......
Page 4: ...iv ...
Page 20: ...xx Conformance to EC Directives 6 ...
Page 48: ...28 Applications Precautions Section 1 4 Example CX Programmer Response Timeout Setting ...
Page 68: ...48 Backup Power Supply Wiring Optical Ring Systems Only Section 2 4 ...
Page 74: ...54 Using the C Library Section 3 2 ...
Page 110: ...90 Changing the Data Link Tables with Active Data Links Section 5 5 ...
Page 187: ......