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

See Also

Mailbox system calls, knCreateRtMailbox, knStopRtScheduler