dlm_TapWriteData()

Writes a single buffer of data to the tap server.

#include "dlmtap.h"

DlmResult dlm_TapWriteData
    (
        DlmLine    line,
        DlmTag     tag,
        DlmFlag    flag,
        DlmSource  source,
        DlmBuffer  buffer,
        DlmSize    size
    );

dlm_TapWriteData() writes a single buffer of data to the tap server.

If successful, dlm_TapWriteData() 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_WriteEvent()
dlm_WriteSignals()

if ((result = dlm_TapWriteData(dlm_Line, dlm_DATA_TAG_OK, 0,
                               dlm_SOURCE_LOCAL, buffer, size)) < 0)
{
    printf("Error: Failure writing data - %s (%d).\n", dlm_ErrorMessage(result), result);
}
else
{
    /* do something */
}