libcm is a C development framework with an emphasis on audio signal processing applications.
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.

cmUdpPort.h 5.3KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136
  1. #ifndef cmUdpPort_h
  2. #define cmUdpPort_h
  3. #ifdef __cplusplus
  4. extern "C" {
  5. #endif
  6. #include <netinet/in.h>
  7. enum
  8. {
  9. kOkUdpRC = cmOkRC,
  10. kSockCreateFailUdpRC,
  11. kSockCloseFailUdpRC,
  12. kSockBindFailUdpRC,
  13. kSockConnectFailUdpRC,
  14. kSockOptSetFailUdpRC,
  15. kSockSendFailUdpRC,
  16. kSockRecvFailUdpRC,
  17. kSockSelectFailUdpRC,
  18. kPtoNFailUdpRC,
  19. kNtoPFailUdpRC,
  20. kNotConnectedUdpRC,
  21. kThreadFailUdpRC,
  22. kQueueFailUdpRC,
  23. kRecvBufOverflowUdpRC,
  24. kBufTooSmallUdpRC,
  25. kHostNameFailUdpRC,
  26. kTimeOutUdpRC
  27. };
  28. typedef cmRC_t cmUdpRC_t;
  29. typedef cmHandle_t cmUdpH_t;
  30. typedef u_short cmUdpPort_t;
  31. extern cmUdpH_t cmUdpNullHandle;
  32. typedef void (*cmUdpCallback_t)( void* cbArg, const char* data, unsigned dataByteCnt, const struct sockaddr_in* fromAddr );
  33. enum
  34. {
  35. kNonBlockingUdpFl = 0x00,
  36. kBlockingUdpFl = 0x01,
  37. kNoQueueUdpFl = 0x02,
  38. kBroadcastUdpFl = 0x04
  39. };
  40. cmUdpRC_t cmUdpAlloc( cmCtx_t* ctx, cmUdpH_t* hp );
  41. cmUdpRC_t cmUdpFree( cmUdpH_t* hp );
  42. cmUdpRC_t cmUdpInit(
  43. cmUdpH_t h,
  44. cmUdpPort_t port, // this sockets port
  45. unsigned flags, // see kXXXUdpFl
  46. cmUdpCallback_t cbFunc, // Callback for use w/ cmUdpGetAvailData()
  47. void* cbArg, // First arg to cbFunc().
  48. const char* remoteAddr, // Remote addr to bind this socket to (or NULL).
  49. cmUdpPort_t remotePort, // Remote port to use with remoteAddr.
  50. unsigned recvBufByteCnt, // Size of the internal receive buffer in bytes. Size of the internal queue and msg receive buffer. No single msg can exceed this size.
  51. unsigned timeOutMs ); // Receive time-out in milliseconds
  52. cmUdpRC_t cmUdpFinal( cmUdpH_t h );
  53. bool cmUdpIsValid( cmUdpH_t h );
  54. // This function may not return a useful value until the
  55. // socket has gone into 'listen' mode.
  56. const struct sockaddr_in* cmUdpLocalAddr( cmUdpH_t h );
  57. // Set a destination address for this socket. Once a destination address is set
  58. // the caller may use cmUdpSend() to communicate with the specified remote socket
  59. // without having to specify an destination address on each call.
  60. cmUdpRC_t cmUdpConnect( cmUdpH_t h, const char* remoteAddr, cmUdpPort_t remotePort );
  61. // Send a message to a remote UDP socket. Use the function cmUdpInitAddr() to setup
  62. // the 'sockaddr_in' arg. for cmUdpSendTo().
  63. cmUdpRC_t cmUdpSend( cmUdpH_t h, const char* data, unsigned dataByteCnt );
  64. cmUdpRC_t cmUdpSendTo( cmUdpH_t h, const char* data, unsigned dataByteCnt, const struct sockaddr_in* remoteAddr );
  65. cmUdpRC_t cmUdpSend2( cmUdpH_t h, const char* data, unsigned dataByteCnt, const char* remoteAddr, cmUdpPort_t remotePort );
  66. // Receive incoming messages by directly checking the internal
  67. // socket for waiting data. This function is used to receive
  68. // incoming data when the internal listening thread is not used.
  69. // Note that if kBlockingUdpFl was set
  70. // in cmUdpInit() that this call will block for available data
  71. // or for 'timeOutMs' milliseconds, whichever comes first.
  72. // If kNonBlockingUdpFl was set in cmUdpInit() then the function
  73. // will return immediately if no incoming messages are waiting.
  74. // If non-NULL *recvByteCntPtr is set to the length of the received
  75. // message or 0 if no msg was received.
  76. cmUdpRC_t cmUdpRecv( cmUdpH_t h, char* data, unsigned dataByteCnt, struct sockaddr_in* fromAddr, unsigned* recvByteCntPtr );
  77. // Start a listening thread. If the queue is enabled then incoming
  78. // messages are received as they arrive and stored in an internal
  79. // queue until the client requests them using cmUdpGetAvailData().
  80. // If the queue is disabled the messages are transmitted immediately
  81. // to the client in the context of the internal listening thread.
  82. cmUdpRC_t cmUdpEnableListen( cmUdpH_t h, bool enableFl );
  83. // Enable/disable the internal queue. If the queue is disabled then
  84. // the receive callback function will be called immediately upon reception
  85. // of the incoming message in the context of the internal listening thread.
  86. // If the queue is enabled then incoming
  87. // messages will be queued until they are transmitted by calling
  88. // cmUdpGetAvailData().
  89. bool cmUdpIsQueueEnabled( cmUdpH_t h );
  90. void cmUdpQueueEnable( cmUdpH_t h, bool enableFl );
  91. // Return the size of the next available message waiting in the
  92. // internal data queue.
  93. unsigned cmUdpAvailDataByteCount( cmUdpH_t h );
  94. // The Call this function to receieve any data waiting in the internal queue.
  95. // Set 'data' to NULL to receive the data via the callback provided
  96. // in cmUdpAlloc().
  97. // On input *dataByteCntPtr must be set to the number of bytes in data[].
  98. // On return *dataByteCntPtr is set to the actual number of bytes copied into data[].
  99. // If fromAddr is non-NULL it is set to the data source address.
  100. cmUdpRC_t cmUdpGetAvailData( cmUdpH_t h, char* data, unsigned* dataByteCntPtr, struct sockaddr_in* fromAddr );
  101. void cmUdpReport( cmUdpH_t h, cmRpt_t* rpt );
  102. // Prepare a struct sockadddr_in for use with cmUdpSendTo()
  103. cmUdpRC_t cmUdpInitAddr( cmUdpH_t h, const char* addrStr, cmUdpPort_t portNumber, struct sockaddr_in* retAddrPtr );
  104. const cmChar_t* cmUdpAddrToString( cmUdpH_t h, const struct sockaddr_in* addr );
  105. const cmChar_t* cmUdpHostName( cmUdpH_t h );
  106. #ifdef __cplusplus
  107. }
  108. #endif
  109. #endif