1 /* ------------------------------------------------------------------
2 * Copyright (C) 1998-2009 PacketVideo
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
14 * See the License for the specific language governing permissions
15 * and limitations under the License.
16 * -------------------------------------------------------------------
18 /****************************************************************************************
19 Portions of this file are derived from the following 3GPP standard:
22 ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec
23 Available from http://www.3gpp.org
25 (C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC)
26 Permission to distribute, modify and use this file under the standard license
27 terms listed above has been obtained from the copyright holder.
28 ****************************************************************************************/
30 ------------------------------------------------------------------------------
36 ------------------------------------------------------------------------------
39 This file contains the type definition and function prototypes used by the
40 SID synchronization functions.
42 ------------------------------------------------------------------------------
48 /*----------------------------------------------------------------------------
50 ----------------------------------------------------------------------------*/
55 /*--------------------------------------------------------------------------*/
61 /*----------------------------------------------------------------------------
63 ; [Define module specific macros here]
64 ----------------------------------------------------------------------------*/
66 /*----------------------------------------------------------------------------
68 ; [Include all pre-processor statements here.]
69 ----------------------------------------------------------------------------*/
70 #define sid_sync_h "$Id $"
72 /*----------------------------------------------------------------------------
73 ; EXTERNAL VARIABLES REFERENCES
74 ; [Declare variables used in this module but defined elsewhere]
75 ----------------------------------------------------------------------------*/
77 /*----------------------------------------------------------------------------
79 ----------------------------------------------------------------------------*/
81 /*----------------------------------------------------------------------------
82 ; ENUMERATED TYPEDEF'S
83 ----------------------------------------------------------------------------*/
85 /*----------------------------------------------------------------------------
86 ; STRUCTURES TYPEDEF'S
87 ----------------------------------------------------------------------------*/
90 Word16 sid_update_rate; /* Send SID Update every sid_update_rate frame */
91 Word16 sid_update_counter; /* Number of frames since last SID */
92 Word16 sid_handover_debt; /* Number of extra SID_UPD frames to schedule*/
93 enum TXFrameType prev_ft;
96 /*----------------------------------------------------------------------------
97 ; GLOBAL FUNCTION DEFINITIONS
98 ; [List function prototypes here]
99 ----------------------------------------------------------------------------*/
100 /* initialize one instance of the sid_sync module
101 Stores pointer to state struct in *st. This pointer has to
102 be passed to sid_sync in each call.
105 Word16 sid_sync_init(void **st);
107 /* reset of sid_sync module (i.e. set state memory to zero)
110 Word16 sid_sync_reset(void *st);
112 /* de-initialize sid_sync module (i.e. free status struct)
115 void sid_sync_exit(void **st);
117 /* update handover debt
118 debtFrames extra SID_UPD are scheduled .
119 to update remote decoder CNI states, right after an handover.
120 (primarily for use on MS UL side )
122 void sid_sync_set_handover_debt(sid_syncState *st, /* i/o: sid_sync state */
125 /* To ensure that the mode only switches to a neighbouring mode */
126 void sid_sync(void *st ,
128 enum TXFrameType *tx_frame_type);
134 #endif /* _SID_SYNC_H_ */