VCI - Virtual CAN Interface - Ixxat

Interface descriptionReturn 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.Comments:A value of more than 0 must be entered for the size of the receive buffer, otherwisethe function returns an error code “Invalid Parameter”.The value entered in the parameter wFifoSize defines the lower limit for thesize of the buffers. The actual size of the buffer may in some cases be largerthan the value specified, as the memory used for this is reserved page-wise.If the function is called for an already initialized monitor, the function firstdeactivates the monitor, then releases the available buffer and generates anew buffer of the required size.4.4.2.6 linMonitorActivateThe function activates or deactivates a message monitor. The complete syntax ofthe function is:HRESULT linMonitorActivate (HANDLE hLinMon,BOOL fEnable );Parameter:hLinMon[in] Handle of the opened LIN message monitor.fEnable[in] With the value TRUE, the function activates the message receptionbetween the LIN controller and the message monitor, with the value FALSEthe function deactivates the message flow.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.Comments:The message monitor is deactivated by default when it is opened or initialized.In order for the monitor to receive messages, it must be activated. At the sametime, the LIN controller must be in the “online” state. Further information onthis is given in the sections 3.2.2 and 3.2.3.After successful activation of the monitor, messages can be read out of the receivebuffer with the functions linMonitorPeekMessage and linMonitorRead-Message.85Copyright IXXAT Automation GmbH C-API Programming Manual, Version 1.5