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.
LVCA_API BOOL WINAPI LVCA_GetConceptA(HANDLE hCA, LPCSTR Module, LPSTR Concept, LONG * Size, LONG * Confidence);
LVCA_API BOOL WINAPI LVCA_GetConceptW(HANDLE hCA, LPCWSTR Module, LPWSTR Concept, LONG * Size, LONG * Confidence);
LVCA_GetConcept
If successful,LVCA_GetConceptA/LVCA_GetConceptW 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.
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.
Modules will only store successful recognitions from its local grammar. Within the CA DLL, the program may evaluate these recognitions on any event, in any module, for any other module. The system updates the concept just before it fires the CAMSG_REC_AFTER_CONFIRM event; however, it does not save global concepts, added concepts, or concepts added through a standard grammar. The program may evaluate these values using the function LVCA_GetRawConcept during the CAMSG_REC_BEFORE_CONFIRM event. If this information needs to be saved for later evaluation it should be placed in a structure or class stored in the call's User Data pointer.
This is a generic call for all module types. As certain module types have more information than this function retrieves it may be more appropriate to use the specific function for that type of module.
CAPI Only mode: Not supported
Warning: The Size 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