ISpEventSource::SetInterest
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método define o tipo de eventos que irá invocar uma notificação e se tornam enfileirado. Se SetInterest Nunca é chamado, os padrões mecanismo SR para SPEI_RECOGNITION como os juros evento somente. Há eventos serão passados pelo se ambos os parâmetros estiverem definidos como zero. Por padrão, o SpVoice objeto padrões para zero para o evento interesse e enfileirado evento.
Syntax
HRESULT SetInterest(
ULONGLONG ullEventInterest,
ULONGLONG ullQueuedInterest
);
Parameters
- ullEventInterest
[no] Evento identificador sinalizadores indicando os eventos que devem invocar uma notificação para o coletor de eventos que usa este fonte de evento.
- ullQueuedInterest
[no] Evento identificador sinalizadores indicando os eventos que devem ser enfileirado. Os sinalizadores evento definidos aqui também devem ser definidos no ullEventInterest.
Return Value
A seguinte tabela mostra os valores possíveis de retorno.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
Sinalizadores inválidos passados em um ou mais campos. |
FAILED(hr) |
Mensagem de erro apropriadas |
Remarks
The SPFEI macro é usado para converter uma enumeração evento para o apropriado sinalizadores para transmitir para este método. De exemplo, para receber os eventos SPEI_RECOGNITION e SPEI_HYPOTHESIS, chamar este método como segue:
ULONGLONG ullMyEvents = SPFEI(SPEI_RECOGNITION) | SPFIE(SPEI_HYPOTHESIS);
Hr = pEventSource->SetInterest(ullMyEvents, ullMyEvents);
Eventos especificados em ullEventInterest Deve ser um supraconjunto desses especificado no enfileirado juros (ullQueuedInterest). Para eventos não adicionado à fila de evento, mas definir em ullEventInterest, a notificação será chamado, mas nenhum evento será enfileirado. Isso pode ser útil para pesquisa o GetStatus método, especialmente para Text to Speech.
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |