RtecatForceModuleInputByte

RtecatForceModuleInputByte writes a byte into an input buffer of a simulated module.

Syntax

Copy

RTECAT_ERROR RtecatForceModuleInputByte(
  [in]    RTECAT_HANDLE Module,
  [in]    ULONG ByteOffset,
  [in]    BYTE Value
);

Parameters

[in] Module

A handle to a module. To retrieve the corresponding handle, use RtecatOpenModuleByIndex or RtecatOpenModuleByLocation.

[in] ByteOffset

A byte offset to the location to write a BYTE value.

[in] Value

A BYTE value to write into an input buffer of a simulated module.

Return Values

The function returns an RTECAT_ERROR value. If the function succeeds, it returns ecatErrNoError. If the function fails, it returns a different value.

Possible return values:

Return value	Meaning
ecatErrNoError	The function succeeded.
ecatErrWrongParameter	Parameter Module or ByteOffset is invalid.
ecatErrMainDeviceNotReady	The MainDevice is not ready.
ecatErrWrongEnvironment	One of the following conditions occurred: The link has not started. The module is not a simulated module.

Remarks

RtecatForceModuleInputByte is a synchronous function that executes immediately and returns a result upon completion.

Requirements

Minimum supported version	Header	Library
wRTOS 1.0 SDK	RtecatApi.h	RtecatApi_W64.lib (Windows), RtecatApi.lib (RTSS)