HRESULT PathScorePhoneme(DWORD *paNodes, DWORD dwNumNodes,
LONG *plScore);
Determines the score for a particular phoneme path.
· Returns NOERROR if successful, or one of these error values:
E_INVALIDARG
E_OUTOFMEMORY
SRERR_NOTENOUGHDATA
SRERR_NOTSUPPORTED
SRERR_VALUEOUTOFRANGE
paNodes
[in] Address of an ordered array of nodes that defines the path. The path must start at node 1 or one of its alternate nodes, end at a terminal node, and be contiguous. If these conditions are not met, the engine cannot calculate the score and it returns an error.
dwNumNodes
[in] Number of nodes in the path and, therefore, also the number of elements in the array.
plScore
[out] Address of a variable that receives the score for the path. The score is normalized, so the engine considers any score less than 0 to be unrecognizable (that is, the utterance is not in the grammar). Phoneme score values from the same speech-recognition results object can be compared against each another.
An application can use the score to determine whether the engine determined the recognition was valid or whether one path is better than another.