ISpVoice::SetVolume
.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 volume de base nível da voz em tempo real. O volume de base usar como padrão para todas as vozes é 100.
Syntax
HRESULT SetVolume(
USHORT usVolume
);
Parameters
- usVolume
[no] Valor especificando o volume solicitada nível. Níveis de volume são especificados em valores porcentagem variando de 0 a 100. Valores fora este intervalo podem ser truncados.
Return Value
A seguinte tabela mostra os valores possíveis de retorno.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
Um ou mais argumentos estão inválido. |
Remarks
Volume é especificado como uma porcentagem do volume Máximo do atual voz. Vozes diferentes podem ter níveis diferentes volume máximo.
Aplicativos podem ajustar o volume de uma voz através de chamar esta função, ou por intermédio XML passado para a voz com a entrada texto de um chamar de fala. A voz deve combinar volume ajustes feitos essas duas maneiras para chegar em um volume final.
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |