Note: As of July 2007, all functions relating to concept/phrase grammars have been deprecated in favor of SRGS grammars. These functions are subject to being removed in a future release. Please update your applications accordingly. See Using SRGS Grammars for more information on working with SRGS grammars.
This function will retrieve a specific questions response
LVCA_API BOOL WINAPI LVCA_GetMultiLevelConceptA(HANDLE hCA, LPCSTR Module, LONG Level, LPSTR Concept, LONG * Size, LONG * Confidence);
LVCA_API BOOL WINAPI LVCA_GetMultiLevelConceptW(HANDLE hCA, LPCWSTR Module, LONG Level, LPWSTR Concept, LONG * Size, LONG * Confidence);
LVCA_GetMultiLevelConcept
If successful,LVCA_GetMultiLevelConceptA/LVCA_GetMultiLevelConceptW returns true. If false is returned, call LVCA_GetLastCallError to retrieve the error code and message.
CAMSG_ENTERMODULE
CAMSG_REC_BEFORE_CONFIRM
CAMSG_REC_AFTER_CONFIRM
CAMSG_TIMEOUT
CAMSG_ERROR
hCA (IN) Call handle passed into function
Module (IN) The pointer to a string containing the module name.
Level (IN) The question number of the concept to retrieve. This is 1 based index, i.e. send 1 to get the first response
Concept (OUT) The pointer to memory to receive the concept string.
Size (IN) (OUT) A pointer to a LONG containing the size of the concept buffer.
Confidence (OUT) A pointer to a LONG to receive the confidence score for the concept
This will retrieve the last confirmed recognition per level the caller was identified as saying in the module specified. The Platform system will store each questions response. If the first question asks what state and then asks the city, the first concept will be the state and the second will have the city.
These values are persistent until the caller re-enters the module or the call ends
This is a specific call for all Multilevel module types.
CAPI Only mode: Not supported.
Warning: The PriSize parameter and the SecSize parameter will be set to the size of the string returned. Set this value before each call if it is used in multiple calls.
Complete Help Topic List | Speech Platform Product Information