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

See Also

INtimeDotNet system calls, Mailbox system calls