LVCA_GetRawConceptA / LVCA_GetRawConceptW

Retrieves the raw concepts from the recognizer.

LVCA_API BOOL WINAPI LVCA_GetRawConceptA(HANDLE hCA, LONG Index, LPSTR Concept, LONG * Size, LONG * Confidence);

LVCA_API BOOL WINAPI LVCA_GetRawConceptW(HANDLE hCA, LONG Index, LPWSTR Concept, LONG * Size, LONG * Confidence);

Defined as:

LVCA_GetRawConcept

Return Value:

If successful,LVCA_GetRawConceptA/LVCA_GetRawConceptW returns true.  If false is returned, call LVCA_GetLastCallError to retrieve the error code and message.

Supported on Events:

CAMSG_REC_BEFORE_CONFIRM

Params:

hCA (IN) The handle given by the event callback.

Index (IN) range = 0 to (count - 1)

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.  Range 0 - 1000 anything above 500 should be a definite match.  50 or below usually is a misrecognition.

Notes:

By design, the Platform evaluates the raw concepts it perceives and produces a single identified concept.  However, on the event CAMSG_REC_BEFORE_CONFIRM, a CA DLL may evaluate the raw concepts and subsequently direct the Platform to perform the appropriate actions.  If the program design does not direct the module to take an action by calling LVCA_SetGoto or LVCA_SetTransfer, any added concept or added standard grammar will be treated as a no match.

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