RtdbgSendBasicMessageIsr

RtdbgSendBasicMessageIsr sends a Basic message from an Interrupt Service Routine (ISR).

Syntax

Copy 
DWORD RtdbgSendBasicMessageIsr(
  [in]    ULONG Category,
  [in]    RTDBG_SEVERITY Severity,
  [in]    wchar_t* pMessage,
  [in]    BOOL AppendValues,
  [in]    long long Value0,
  [in]    long long Value1,
  [in]    double Value2,
  [in]    double Value3,
  [in]    ULONG SpinCount
);

Parameters

[in] Category

The index of the message category. This value is between 0 and 63.

[in] Severity

The severity of the message described in RTDBG_SEVERITY.

[in] pMessage

The message text in Unicode characters. The maximum length is 128 characters. You can insert Value0, Value1, Value2, and Value3 into the message using .NET's string.Format rules for formatting, such as {0:X}, where {0} represents Value0 and "X" specifies hexadecimal format. See String Messages for more details.

[in] AppendValues

A flag indicating whether the values should be printed at the end of the message.

[in] Value0

The first value.

[in] Value1

The second value.

[in] Value2

The third value.

[in] Value3

The fourth value.

[in] SpinCount

The number of times the function should retry acquiring the channel lock before failing.

Return Values

Error code Meaning

ERROR_SUCCESS

The function succeeded.

ERROR_NOT_READY

The calling process hasn't called RtdbgOpenBasicChannel.

ERROR_INVALID_PARAMETER

One of the following conditions occurred:

  • The value of parameter pMessage is NULL.
  • The value of parameter Category is outside the acceptable range (0-63).
  • The value of parameter Severity is invalid.

ERROR_DISCARDED

The message is disabled by the filters.

ERROR_ABANDONED_WAIT_0

Failed to acquire the synchronization lock.

ERROR_NOT_ENOUGH_MEMORY

The channel is full.

Remarks

RtdbgSendBasicMessageIsr is only available for real-time interfaces.

The RtdbgSendBasicMessageIsr function is deterministic.

Requirements

Minimum supported version Header Library

wRTOS 1.0 SDK

RtdbgApi.h

RtdbgApi.lib (RTSS)

See Also: