dlm_TapWriteEvent()

Writes a single, user formatted event to the tap server.

#include "dlmtap.h"

DlmResult dlm_TapWriteEvent
    (
        DlmLine   line,
        DlmEvent  event
    );

dlm_TapWriteEvent() writes a single, user formatted event to the tap server.

If successful, dlm_TapWriteEvent() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dlm_ERROR_CONNECTION_FAILURE
• dlm_ERROR_CONNECTION_INCOMPLETE
• dlm_ERROR_INVALID_COMMAND
• dlm_ERROR_INVALID_LINE_ID
• dlm_ERROR_INVALID_PARAMETERS

dlm_WriteBuffer()
dlm_WriteData()
dlm_WriteSignals()

if ((result = dlm_TapWriteEvent(dlm_Line, &event)) < 0)
{
    printf("Error: Failure writing event - %s (%d).\n", dlm_ErrorMessage(result), result);
}
else
{
    /* do something */
}