VCI - Virtual CAN Interface - Ixxat

Interface description4.4.2.1 linMonitorOpenThe function creates a message monitor for the LIN connection of a device or ofan interface board. The complete syntax of the function is:HRESULT linMonitorOpen (HANDLE hDevice,UINT32 dwLinNo,BOOL fExclusive,PHANDLE phLinMon );Parameter:hDevice[in] Handle of the opened device or of the interface board.dwLinNo[in] Number of the LIN connection of the control unit to be opened. Thevalue 0 selects the first LIN connection, the value 1 the second LINconnection and so on.fExclusive[in] Determines whether the LIN connection is used exclusively for themonitor to be generated. If the value TRUE is entered here, no furthermonitors can be created after a successful call of the function until thegenerated monitor has been released again. With the value FALSE, anynumber of message monitors can be created for the LIN connection.phLinMon[out] Pointer to a variable of type HANDLE. If run successfully, the functionreturns the handle of the opened monitor in this variable. In the event of anerror, the variable is set to the value NULL.Return value:If run successfully, the function returns the value VCI_OK, otherwise an errorcode not equal to VCI_OK. Further information on the error code is providedby the function vciFormatError.If the value TRUE is entered in the parameter fExclusive, no further messagemonitors can be opened after a successful call of the function. This means thatthe first program to call the function with the value TRUE in the parameterfExclusive has exclusive control over the message reception of the LIN connection.Comments:If the parameter dwLinNo is set to the value 0xFFFFFFFF, the function displaysa dialogue window on the screen to select a device or an interface board anda LIN connection. In this case the function expects the handle of a higher orderwindow or the value NULL if no higher order window is available and notthe handle of the device in the parameter hDevice.If the message monitor is no longer required, the handle returned in phLin-Mon should be released again with the function linMonitorClose.82Copyright IXXAT Automation GmbH C-API Programming Manual, Version 1.5