RtGenerateEvent

RtGenerateEvent generates custom Monitoring events.

Syntax

BOOL RtGenerateEvent(
    [in]    unsigned int kind,
    [in]    void * buffer,
    [in]    size_t size
   );

Parameters

[in] kind

A user-selected unique identifier for the custom event. This identifier must be between 0 and 999. Identifiers outside of this range are reserved for internal use.

[in] buffer

Must point to a memory region (no larger than 500 bytes) containing the custom event data.

[in] size

The size of the buffer.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE.

Remarks

If RtGenerateEvent fails, call GetLastError to obtain an error code. The possible errors are as follows:

• ERROR_INVALID_PARAMETER - Parameter "buffer" is NULL or parameter "size" is greater than 500.
• ERROR_BUFFER_OVERFLOW - The internal buffer used to transport monitor data from the RTSS processors to the Windows processors are full. Over time, more space will become available in the buffer.
• ERROR_INVALID_FUNCTION - An internal consistency check has failed.

Requirements

See Also:

• RTMonitorControl