media/mtransport/third_party/nICEr/src/ice/ice_handler.h@b8a032363ba2 (annotated)
media/mtransport/third_party/nICEr/src/ice/ice_handler.h
Thu, 22 Jan 2015 13:21:57 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Thu, 22 Jan 2015 13:21:57 +0100
- branch
- TOR_BUG_9701
- changeset 15
- b8a032363ba2
- permissions
- -rw-r--r--
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
| michael@0 | 1 | /* |
| michael@0 | 2 | Copyright (c) 2007, Adobe Systems, Incorporated |
| michael@0 | 3 | All rights reserved. |
| michael@0 | 4 | |
| michael@0 | 5 | Redistribution and use in source and binary forms, with or without |
| michael@0 | 6 | modification, are permitted provided that the following conditions are |
| michael@0 | 7 | met: |
| michael@0 | 8 | |
| michael@0 | 9 | * Redistributions of source code must retain the above copyright |
| michael@0 | 10 | notice, this list of conditions and the following disclaimer. |
| michael@0 | 11 | |
| michael@0 | 12 | * Redistributions in binary form must reproduce the above copyright |
| michael@0 | 13 | notice, this list of conditions and the following disclaimer in the |
| michael@0 | 14 | documentation and/or other materials provided with the distribution. |
| michael@0 | 15 | |
| michael@0 | 16 | * Neither the name of Adobe Systems, Network Resonance nor the names of its |
| michael@0 | 17 | contributors may be used to endorse or promote products derived from |
| michael@0 | 18 | this software without specific prior written permission. |
| michael@0 | 19 | |
| michael@0 | 20 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| michael@0 | 21 | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| michael@0 | 22 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| michael@0 | 23 | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| michael@0 | 24 | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| michael@0 | 25 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| michael@0 | 26 | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| michael@0 | 27 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| michael@0 | 28 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| michael@0 | 29 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| michael@0 | 30 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| michael@0 | 31 | */ |
| michael@0 | 32 | |
| michael@0 | 33 | |
| michael@0 | 34 | |
| michael@0 | 35 | #ifndef _ice_h |
| michael@0 | 36 | #define _ice_h |
| michael@0 | 37 | #ifdef __cplusplus |
| michael@0 | 38 | using namespace std; |
| michael@0 | 39 | extern "C" { |
| michael@0 | 40 | #endif /* __cplusplus */ |
| michael@0 | 41 | |
| michael@0 | 42 | typedef struct nr_ice_handler_vtbl_ { |
| michael@0 | 43 | /* The checks on this media stream are done. The handler needs to |
| michael@0 | 44 | select a single pair to proceed with (regular nomination). |
| michael@0 | 45 | Once this returns the check starts and the pair can be |
| michael@0 | 46 | written on. Use nr_ice_candidate_pair_select() to perform the |
| michael@0 | 47 | selection. |
| michael@0 | 48 | TODO: !ekr! is this right? |
| michael@0 | 49 | */ |
| michael@0 | 50 | int (*select_pair)(void *obj,nr_ice_media_stream *stream, |
| michael@0 | 51 | int component_id, nr_ice_cand_pair **potentials,int potential_ct); |
| michael@0 | 52 | |
| michael@0 | 53 | /* This media stream is ready to read/write (aggressive nomination). |
| michael@0 | 54 | May be called again if the nominated pair changes due to |
| michael@0 | 55 | ICE instability. TODO: !ekr! think about this |
| michael@0 | 56 | */ |
| michael@0 | 57 | int (*stream_ready)(void *obj, nr_ice_media_stream *stream); |
| michael@0 | 58 | |
| michael@0 | 59 | /* This media stream has failed */ |
| michael@0 | 60 | int (*stream_failed)(void *obj, nr_ice_media_stream *stream); |
| michael@0 | 61 | |
| michael@0 | 62 | /* ICE is completed for this peer ctx |
| michael@0 | 63 | if need_update is nonzero, a SIP update is required |
| michael@0 | 64 | */ |
| michael@0 | 65 | int (*ice_completed)(void *obj, nr_ice_peer_ctx *pctx); |
| michael@0 | 66 | |
| michael@0 | 67 | /* A message was delivered to us */ |
| michael@0 | 68 | int (*msg_recvd)(void *obj, nr_ice_peer_ctx *pctx, nr_ice_media_stream *stream, int component_id, UCHAR *msg, int len); |
| michael@0 | 69 | } nr_ice_handler_vtbl; |
| michael@0 | 70 | |
| michael@0 | 71 | typedef struct nr_ice_handler_ { |
| michael@0 | 72 | void *obj; |
| michael@0 | 73 | nr_ice_handler_vtbl *vtbl; |
| michael@0 | 74 | } nr_ice_handler; |
| michael@0 | 75 | |
| michael@0 | 76 | #ifdef __cplusplus |
| michael@0 | 77 | } |
| michael@0 | 78 | #endif /* __cplusplus */ |
| michael@0 | 79 | #endif |
| michael@0 | 80 |
