SPDUI_AudioVolume
.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
O seqüência de caracteres para exibir um áudio define essa variável volume do objeto interface do usuário.
Quando a implementar
Ao escrever um personalizado áudio objeto, um aplicativo pode modificar as configurações de objeto volume. De exemplo, a implementação do SAPI na multimídia áudio objeto exibe o mixer Windows associado com o áudio dispositivo.
O Painel de controle de fala permite que o usuário para selecionar o áudio usar como padrão entrada e saída objetos. Optar por volume diretamente acessar cada áudio volume do objeto interface do usuário usando SPDUI_AudioVolume. Se o áudio objeto não suporte a Volume UI (consulte ISpTokenUI::IsUISupported), e volume será não disponível.
Quando para o Access
O aplicativo acessa o áudio volume do objeto interface do usuário se a saída for muito alto ou a entrada é muito silencioso.
Além disso, um mecanismo SR pode enviar um evento SPEI_REQUEST_UI para o aplicativo se ele determina que o usuário deve executar microfone treinamento. Normalmente, o tipo interface do usuário será SPDUI_MicTraining para garantir que o mecanismo SR adaptado para o atual entrada áudio configurações. O aplicativo também pode levar essa oportunidade para perguntar o usuário para verificar a entrada áudio configurações. De exemplo, se o áudio entrada volume está muito baixa, seria preferível para aumentar o áudio entrada volume, em vez de peça o mecanismo SR para ampliam um áudio ruim entrada sinal.
SAPI geralmente obedecem não as alterações nas configurações do mixer Windows. Este mixer fica disponível somente como último recurso na Ajustando um som misbehaving sistema quando o assistente Microphone Training Falha ao definir o volume adequadamente.
#define SPDUI_AudioVolume L"AudioVolume"
Example
O seguinte trecho de código ilustra o uso de ISpTokenUI::IsUISupported Usando SPDUI_AudioVolume.
HRESULT hr = S_OK;
// get the default input audio object token
hr = SpGetDefaultTokenFromCategoryId(SPCAT_AUDIOIN, &cpObjectToken);
// Check hr
// get the object token's UI
hr = cpObjectToken->QueryInterface(&cpTokenUI);
// Check hr
// check if the default audio input object has UI for Volume
hr = cpTokenUI->IsUISupported(SPDUI_AudioVolume, NULL, NULL, NULL, &fSupported);
// Check hr
// if fSupported == TRUE, then default audio input object has UI for Properties