DLM Tap

Tap Write Event

dlm_TapWriteEvent()

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

Syntax
#include "dlmtap.h"

DlmResult dlm_TapWriteEvent
    (
        DlmLine   line,
        DlmEvent  event
    );
lineid of session to write to
eventevent to write
Description

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

Return Values

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:

See Also

dlm_WriteBuffer()
dlm_WriteData()
dlm_WriteSignals()

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