You are reading help file online using chmlib.com
|
ISpRecoContext::Resume releases the SR engine from the paused state and restarts the recognition process.
HRESULT Resume (
DWORD dwReserved
);
Value | Description |
---|---|
S_OK | Function completed successfully. |
E_INVALIDARG | dwFlags is not set to zero. |
This method must be called after a call to ISpRecoContext::Pause, a bookmark event occurs that pauses the recognition engine, or an auto-pause rule is recognized (see ISpRecoGrammar::SetRuleState).
The caller must call Resume once for every call that is made to ISpRecoContext::Pause.
The following code snippet illustrates the use of ISpRecoContext::Resume after a call to ISpRecoContext::Pause
HRESULT hr = S_OK;
// setup the recognition context
// ...
// pause the context so that event notifications are not received
hr = cpRecoContext->Pause( NULL );
// Check hr
// [quickly] perform the processing - see ISpRecoContext::Pause Remarks section
// ...
hr = cpRecoContext->Resume( NULL );
// Check hr
// applications will start receiving event notifications again
The following code snippet illustrates the use of ISpRecoContext::Resume with an "auto-pause" rule.
HRESULT hr = S_OK;
// setup the recognition context and grammar
// ...
// activate a top-level rule as an "auto-pause" rule
hr = cpRecoGrammar->SetRuleState( MY_AUTOPAUSE_RULE, NULL, SPRS_ACTIVE_WITH_AUTO_PAUSE);
// Check hr
// get the recognition event for MY_AUTOPAUSE_RULE in a CSpEvent object
// ...
// assert that the recognition context paused after the "auto-pause" rule was recognized
SPDBG_ASSERT(spEvent.IsPaused());
// deactivate the "auto-pause" rule
hr = cpRecoGrammar->SetRuleState( MY_AUTOPAUSE_RULE, NULL, SPRS_INACTIVE );
// Check hr
// activate the second rule
hr = cpRecoGrammar->SetRuleState( MY_SECOND_RULE, NULL, SPRS_ACTIVE );
// Check hr
// Since the context was paused from the "auto-pause" rule, it must now be reactivated to recognize the second rule
hr = cpRecoContext->Resume( NULL );
// Check hr
// get the second recognition...
You are reading help file online using chmlib.com
|