HMS FlexRay CCM, Руководство по программированию

Страница: 62 / 71

Copyright IXXAT Automation GmbH
UCI Programming Manual FlexRay, V1.13
Annex
62
6.2 Registration Functions (XAT xx Reg.DLL)
The VCI_V2 introduced the possibility to register PC/CAN-interfaces which can be
addressed via the VCI, under a
unique index number in the system.
The VCI_V2 now provides an interface with the XAT xx Reg.DLL ( xx stands for ver-
sion number, e.g. 10) in order to access this registration information.
The interface to this DLL is contained in the Header-file XAT
xx
Reg.h with the
same name. For integration of the XAT xx Reg.DLL, the same notes apply as for the
UCI-DLL in Section 5.1.1.1.
In the following, only those functions of the XAT
xx Reg.DLL are described which
are necessary for a VCI-application in order to access information on the PC/CAN-
interfaces registered in the system.
The functions provided cover the following areas:
•
Listing (enumeration) of all registered PC/CAN-interfaces and the assigned pa-
rameters
•
Search for a certain PC/CAN-interface
•
Call-up of a hardware-selection dialogue
•
Reading of the configuration of a PC/CAN-interface
•
Selection/querying of a system-wide default-PC/CAN-interface
6.2.1 Type Definitions of the Call-back Handler
The XATxxReg.DLL uses Call-back-mechanism in order to read out all available
information on registered PC/CAN-interfaces.
6.2.1.1 Call-back to list the registered PC/CAN-interfaces
The registered PC/CAN-interfaces are transferred to this function after call-up of
the function
XAT_EnumHwEntry() .
Typdefinition:
typedef short (XATREG_CALLBACKATTR *
ENUM_CALLBACK
)
( int i_index, int hw_key, char * name, char * value, char * valu-
ehex, void* vp_context);
Parameter: i_index (in)
Type of entry.
•
0 -> Hardware entry
• 1 -> Hardware parameter
hw_key (in)
Unique index number, under which the PC/CAN-interface is reg-
istered with the system.