LVSpeechPort::ActivateGlobalGrammar

You only need to use this function if you have a grammar in the speech port with same name as a grammar in the global space, and you wish to activate the global grammar.

Function

• int LVSpeechPort::ActivateGlobalGrammar(const char* gram_name);

Parameters

gram_name

The identifier for the grammar being activated. This is the same identifier that was given to the grammar when it was loaded.

Return Values

LV_SUCCESS

No errors; this grammar is now active.

LV_FAILURE

This grammar could not be activated, because the port was shutting down.

LV_INVALID_GRAMMAR_LABEL

The input gram_name specifies a grammar that is not available for activation (either not loaded or has been unloaded).

LV_INVALID_HPORT

The port is not valid (either CreateClient has not been called or DestroyClient has been called prior to this call).

LV_EXCEPTION

An exception occured while processing the request.

Remarks

Since LVSpeechPort::ActivateGrammar searches the speech port's loaded grammars, and then searches the application level grammars, you only need to use LV_SRE_ActivateGlobalGrammar if there is a name conflict between your local and app-level grammars, and you need to activate the app-level one.

Detailed error and warning messages are sent to the speech port's logging callback function at priorities 0 and 1, respectively.

See Also

• LVSpeechPort::ActivateGrammar
• LVSpeechPort::DeactivateGrammar
• LVSpeechPort::DeactivateGrammars
• LV_SRE_ActivateGrammar (C API)