Compartilhar via


IAgentCommandsEx::SetGlobalVoiceCommandsEnabled

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

HRESULT SetGlobalVoiceCommandsEnabled(
 long bEnable  // Enabled setting for Agent's global voice commands
);

Define a propriedade Enabled para a gramática de voz dos comandos globais do Microsoft Agent.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

bEnable

Um valor booliano que define se a gramática de voz dos comandos globais do Agente está habilitada. True habilita a gramática de voz; False o desabilita.

O Microsoft Agent adiciona automaticamente parâmetros de voz (gramática) para abrir e fechar a janela Comandos de Voz e para mostrar e ocultar o caractere. Quando definido como False, o Agent desabilita todos os parâmetros de voz para esses comandos, bem como os parâmetros de voz para ode Legenda dedos objetos decomandode outro cliente. Isso permite que você elimine-os da gramática ativa atual do cliente. No entanto, como isso potencialmente bloqueia o acesso de voz a outros clientes, redefina essa propriedade para True depois de processar a entrada de voz do usuário.

Desabilitar a propriedade não afeta o menu pop-up do caractere. Os comandos globais adicionados pelo servidor ainda serão exibidos. Você não pode removê-los do menu pop-up.

Consulte Também

IAgentCommandsEx::GetGlobalVoiceCommandsEnabled