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.
Retrieve the primary and secondary concept from a natural language module
LVCA_API BOOL WINAPI LVCA_GetNatLangConceptsA(HANDLE hCA, LPCSTR Module, LPSTR PriConcept, LONG * PriSize, LPSTR SecConcept, LONG * SecSize, LONG * Confidence);
LVCA_API BOOL WINAPI LVCA_GetNatLangConceptsW(HANDLE hCA, LPCWSTR Module, LPWSTR PriConcept, LONG * PriSize, LPWSTR SecConcept, LONG * SecSize, LONG * Confidence);
LVCA_GetNatLangConcepts
If successful,LVCA_GetNatLangConceptsA/LVCA_GetNatLangConceptsA 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) The handle given by the event callback.
Module (IN) The pointer to a string containing the module name.
PriConcept (OUT) The pointer to memory to receive the primary concept string.
PriSize (IN) (OUT) A pointer to a LONG containing the size of the primary concept buffer.
SecConcept (OUT) The pointer to memory to receive the secondary concept string.
SecSize (IN) (OUT) Size of the Secondary Concept buffer.
Confidence (OUT) A pointer to a LONG to receive the confidence score for the concept
This will retrieve the last confirmed recognition the caller was identified as saying in the module specified.
These values are persistent until the caller re-enters the module or the call ends.
This is a specific call for all natural language 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