Compartilhar via


ISpRecoContext::SetVoicePurgeEvent

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Este método define eventos mecanismo SR que áudio parar saída e limpa o atual falar fila. Os aplicativos podem chamar esse método quando estiver implementando "barge-in" a funcionalidade. De exemplo, quando um usuário chama um servidor telefonia, e o servidor usa prompts de voz do TTS, a voz deve parar fala quando o usuário está falando. O objeto de voz quer o aplicativo associado com o contexto de reconhecimento de fala para parar e limpar quando o mecanismo SR ouve um som.

Syntax

HRESULT SetVoicePurgeEvent(
  ULONGLONG ullEventInterest
);

Parameters

  • ullEventInterest
    [no] O conjunto de sinalizadores indicando o interest(s) evento para o conjunto de eventos de reconhecimento de fala. Eventos possíveis são definidos pelo SPEVENTENUM ) enumeração.

Return Value

A seguinte tabela mostra os valores possíveis de retorno.

Value Description

S_OK

Function completed successfully.

E_INVALIDARG

Um ou mais dos Conjunto de interesses de evento não é permitido.

FAILED(hr)

Mensagem de erro apropriadas

Remarks

Os juros evento contexto de reconhecimento de fala serão atualizado para incluir os eventos limpar de voz. Consulte ISpEventSource::SetInterest. Para localizar o atual voz limpar event(s), o aplicativo deve chamar ISpRecoContext::GetVoicePurgeEvent.

Example

O seguinte trecho de código ilustra o uso desse método e "barge-in" instalação.

HRESULT hr = S_OK;
// create a shared recognition context
hr = cpRecoContext.CoCreateInstance(CLSID_SpSharedRecoContext);
// Check hr
// create a voice from the context (with same audio format as context)
hr = cpRecoContext->GetVoice(&cpVoice);
// Check hr
// tell the associated Voice to stop speaking when the SR Engine hears a
recognizable sound
hr = cpRecoContext->SetVoicePurgeEvent(SPFEI(SPEI_SOUND_START));
// Check hr

Requirements

Header sapi.h, sapi.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

ISpRecoContext
SAPI Interfaces