INtime SDK Help
knSendRtData
INtime SDK v7 > About INtime > INtime Kernel > Mailboxes > knSendRtData

Sends a data message to the given low-level mailbox.

BOOLEAN knSendRtData(
    KNHANDLE hMailbox,   // handle for low-level mailbox
    LPVOID lpData,       // pointer to data message
    DWORD cbBytesSent       // number of bytes in message
);

Parameters

hMailbox
Handle for low-level mailbox, previously created with knCreateRtMailbox.
lpData
Pointer to the area containing the message to be sent.
cbBytesSent
Number of bytes in the message to be sent. The value can be no greater than the maximum message size specified when the mailbox was created.

Return Values

TRUE
Success
FALSE
To determine the status, call GetLastRtError

Status

E_OK
The mailbox accepted the message.
E_KN_LIMIT_EXCEEDED
The message was rejected because the mailbox was full.
Note:   If you use this call from an interrupt handler, use knStopRtScheduler before making the call.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib

See Also

Mailbox system calls, knCreateRtMailbox, knStopRtScheduler