Skip to main content
Open topic with navigation CAPL Functions » Ethernet » Function Overview » GetServiceSignalData

​
GetServiceSignalData

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long GetServiceSignalData(serviceSignal qualifier, byte buffer [], dword bufferLength); // form 1
  • long GetServiceSignalData(char qualifier [], byte buffer [], dword bufferLength); // form 2

​
Description

Reads the data of a Service Signal.

​
Parameters

  • qualifier: Qualifier of the Service Signal.
  • buffer[]: Data buffer for the value of the Service Signal.
  • bufferLength: Length of the data buffer.

​
Return Values

  • >=0: Number of bytes that have been fetched from the Service Signal.
  • -1: Service Signal not found. No Service Signal matches the qualifier.
  • -3: Invalid buffer or buffer length. The length of the buffer has to be greater than zero.
  • -5: Service Signal has not been observed until now.
  • -255: General error occurred.

​
Example

on key 'r'
{
  byte buffer[255];
  GetServiceSignalData(DemoDatabase::PACKAGE1::PACKAGE2::Service1::1::2::Event1::StringValue, buffer, elcount(buffer));
}
Note: The service qualifier is specified without a leading $ sign. GetServiceSignal • GetServiceSignalString • SetServiceSignalData