cniSetInputBuffer

Using this function, the caller can supply a buffer. It is used by input nodes only. The address is specified by the source parameter as an input bitstream of the input message to the broker. By supplying a buffer, an input node can read data into the bitstream representing an input message from an external data source. The broker can access this buffer at any time while the message object it is attached to is being propagated through a message flow.

Syntax

int cniSetInputBuffer(
  void*        returnCode,
  CciMessage*  message,
  Void*        source,
  CCiInt       length);			

Parameters

returnCode
The return code from the function (output). Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
message
The message object that uses the buffer described by the source parameter to represent the input bitstream. (input)
source
The address of the buffer to be used as input. (input)
length
The length of the input buffer described by the source parameter. (input)

Return values

None. If an error occurs, the returnCode parameter indicates the reason for the error.

Example

   cniSetInputBuffer(&rc, message, buffer, buflen);
Related concepts
User-defined input nodes