Wavenet Technology BM3-800D, Руководство пользователя

Страница: 101 / 146

Boomer-III User Manual & Integrator’s Guide______________________Appendix B – SDK NCL-API and Port Server
BM310012WT04 101 Copyright Wavenet Technology © October 2003
The RCV_MSG_NOTIFICATION event will be handled by the VDD,
which will read the messages from the RPM and pass the messages to
all clients with open sessions.
Other Event types shall be posted to all clients with open sessions
registered for that event. If no applications are registered for that event
the event will be disabled in the modem.
Prototype:
int nclReceiveData(DWORD dwTimeOut, BYTE *ucStructId, WORD
*usSduTag, int *iBufLen, BYTE *ucBuf);
Description:
Receive messages from the RPM.
Input
:
dwTimeOut The time (in milliseconds) to wait for the next message. Use 0 to
return immediately or FFFFFFFF (hexadecimal) to hang on
indefinitely for a message. The calling thread will be suspended
until a message arrive or the time-out period has elapsed,
whichever occurs first.
ucStructId Pointer to a byte where the structure ID can be stored.
usSduTag Pointer to a word where the SDU tag can be stored
iBufLen Pointer to a integer specifying the total size of ucBuf.
ucBuf Pointer to the buffer (of size iBufLen) where receive data can be
placed
Output:
Return value = 0 Operation was successful
Return value ≠ 0 Operation failed. Value specifies the error type
ucStructId This value identifies the structure of the data in ucBuf. See the
following paragraphs for details.
usSduTag Pointer to a word containing a reference of the corresponding
SDU tag which was generated by the NCL API for this command
to the RPM.
iBufLen Size (in bytes) of the data in ucBuf. Note: Buffer lengths of 0 is
possible – rely solely on the return value in such cases
ucBuf Pointer to buffer containing the received data