mcEventCreate

ECU Measurement and Calibration Toolkit Help

Edition Date: October 2018

Part Number: 371602T-01

»View Product Info
Download Help (Windows Only)

Purpose

Creates an Event object in memory.

Format

mcTypeStatus mcEventCreate(
mcTypeTaskRef ECURefNum,
cstr EventChannelName,
u8 EventChannelNumber);

Input

ECURefNum

ECURefNum is the task reference that links to the selected ECU. This reference is originally returned from mcECUCreate.

EventChannelName

EventChannelName identifies the Event Channel object.

EventChannelNumber

EventChannelNumber identifies the number of the Event Channel. The event channel number specifies the generic signal source that effectively determines the data transmission timing. To allow a reduction of the desired transmission rate, a prescaler may be applied to the Event Channel. The prescaler value factor must be greater than or equal to 1 to use mcSetProperty using mcPropDAQ_Prescaler.

Output

Return Value

The return value indicates the status of the function call as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.

Description

Use the function mcEventCreate to create an Event object in memory instead of referring to a predefined Event Channel in the A2L database. Assign the event channel object by name to a DAQ List in mcMeasurementCreate.

WAS THIS ARTICLE HELPFUL?

Not Helpful