SetResultsHookHREC
2.0
Sets up a
hook callback function for recognition results.
HRECHOOK SetResultsHookHREC( HREC hrec,
HRCRESULTHOOKPROC lpfnHook )
Parameters
hrec
Module handle
of the recognizer library whose results are to be hooked. If hrec is set
to NULL, the hook function specified in lpfnHook receives results from
the system default recognizer. If hrec is set to SRH_HOOKALL, the hook
function receives results for all recognizers the application has installed,
including the system recognizer.
lpfnHook
Address of
the hook function.
Return Value
Returns a
handle to the installed hook if successful; otherwise, the return value is
NULL. The application must provide this handle when calling UnhookResultsHookHREC to remove the hook.
Comments
An application
can set multiple hooks. The system calls the hooks in reverse order that is, the most-recently-set hook is called first,
then the previous hook, and so on. If a hook function captures a result, the
function that requested the results returns HRCR_HOOKED to the application.
See Also