INtime SDK Help
ntxSendRtDataXxx(INtimeDotNet)
INtime SDK v7.1 > About INtime > Alternate APIs > INtimeDotNet > ntxSendRtDataXxx(INtimeDotNet)

Copies data to an RT data mailbox.

These functions correspond to the NTX function ntxSendRtData. They send respectively 1, 2 or 4 bytes, or a stream of bytes.

Visual Basic:

Sub ntxSendRtData1Byte(
  ByVal hMailbox As Integer,
  ByVal bSrc As Byte)
Sub ntxSendRtData2Bytes(
  yVal hMailbox As Integer,
  ByVal wSrc As Short)
Sub ntxSendRtData4Bytes(
  ByVal hMailbox As Integer,
  ByVal lSrc As Integer)
Sub ntxSendRtDataBytes(
  ByVal hMailbox As Integer,
  ByVal aSrc() As Byte,
  ByVal wActualLength As Integer)

Visual C#:

void ntxSendRtData1Byte (
  Int32 hMailbox,
  Byte bSrc );
void ntxSendRtData2Bytes (
  Int32 hMailbox,
  Int16 wSrc );
void ntxSendRtData4Bytes (
  Int32 hMailbox,
  Int32 lSrc );
void ntxSendRtDataBytes (
  Int32 hMailbox,
  Byte[] aSrc,
  Int32 wActualLength);

Parameters

hMailbox
Handle of the RT data mailbox to send to.
pMessage
Pointer to the data to send.
aSrc
An array of bytes to send. wActualLength defines how many bytes are sent.
bSrc
A one-byte variable to send.
lSrc
A four-byte variable to send.
wSrc
A two-byte variable to send.
wActualLength
Number of bytes sent in this operation.

Status

E_MEM
The data message queue is full and the system does not have enough memory to create another.
E_LIMIT
wActualLength is greater than 128 (the maximum that can be sent in one operation).
E_EXIST
hMailbox is not a handle for an existing object.
E_TYPE
hMailbox is not a handle for a data mailbox.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.

Requirements

Versions Reference
INtime 3.0 INtimeDotNet

See Also

INtimeDotNet system calls, Mailbox system calls