
DCN Next Generation Open Interface Release 2.4 Microphone Management
en | 94
Bosch Communications Systems | 2007 February | SRS_MMINF | Du020903
3.3.1 MM_C_SET_MICRO_ON_OFF
Purpose
Control the microphone of a unit. This function gives the ability to turn the microphone of a
unit on or off. To describe the functionality included with this function several cases of this
function are described in the table below:
Case Action performed
Delegate unit micro on The unit is appended to the SPK list if possible.
Delegate unit micro off The units’ microphone is turned off, but the unit still
remains in the SPK list. To remove the speaker also from
the SPK list, use the remote call MM_C_SPK_REMOVE
(see section 3.3.3).
Delegate unit micro on
(already in the SPK list)
The units’ microphone is turned on. The unit remains in
the SPK list.
Chairman unit micro on The units’ microphone is turned on.
Chairman unit micro off The units’ microphone is turned off.
Parameter structure for the function
The function requires the following structure as parameter:
typedef struct
{
WORD wUnitId;
BOOLEAN bMicroOn;
} MM_T_MICRO_ONOFF;
where:
wUnitId Unit Identifier. Unit identifiers can be retrieved from the system
using the remote functions for System Config [SRS_SCSIINF].
bMicroOn TRUE to turn the microphone on,
FALSE to turn the microphone off
Response structure from the function
The function has no response parameters.
Error codes returned
MM_E_NOERROR
MM_E_SPEAKERS_LIST_FULL
MM_E_INSERT_SPEAKERS_LIST_FAILED
MM_E_NOT_IN_SPL_OR_NOB
MM_E_UNIT_NOT_CONNECTED
MM_E_ILLEGAL_MIC_OPER_MODE
MM_E_ILLEGAL_MICRO_TYPE
Update notifications
MM_C_SPK_APPEND_ON_PC (delegate micro on and added to SPK)
MM_C_MICRO_ON_OFF (micro on/off and already in SPK)
Related functions
MM_C_SPK_APPEND
MM_C_SPK_REMOVE
3.3.2 MM_C_SPK_APPEND
Purpose
Add a unit to the end of the speakers list on the CCU. The addition of a unit to the SPK list
automatically implies that the microphone will be turned on.
Note that this function always adds the unit to the speakers list. Even if this unit is a chairman.
A good practice is to use the remote function MM_C_SET_MICRO_ON_OFF for managing
the microphones state.
Komentáře k této Příručce