IAgentAudioOutputPropertiesEx::GetStatus

[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]

HRESULT GetStatus(
   long * plStatus,  // address of audio channel status
);

Recupera o status do canal de áudio.

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

plStatus

Status do canal de saída de áudio, que pode ser um dos seguintes valores:

Valor	Descrição
const unsigned shortAUDIO_STATUS_AVAILABLE = 0;	O canal de saída de áudio está disponível (não ocupado).
const unsigned shortAUDIO_STATUS_NOAUDIO = 1;	Não há suporte para saída de áudio, por exemplo, porque não há placa de som.
const unsigned shortAUDIO_STATUS_CANTOPENAUDIO = 2;	O canal de saída de áudio não pode ser aberto (está ocupado), por exemplo, porque outro aplicativo está reproduzindo áudio.
const unsigned shortAUDIO_STATUS_USERSPEAKING = 3;	O canal de saída de áudio está ocupado porque o servidor está processando a entrada de fala do usuário
const unsigned shortAUDIO_STATUS_CHARACTERSPEAKING = 4;	O canal de saída de áudio está ocupado porque um caractere está falando no momento.
const unsigned shortAUDIO_STATUS_SROVERRIDEABLE = 5;	O canal de saída de áudio não está ocupado, mas está aguardando a entrada de fala do usuário.
const unsigned shortAUDIO_STATUS_ERROR = 6;	Houve algum outro problema (desconhecido) ao tentar acessar o canal de saída de áudio.

Essa configuração permite que o aplicativo cliente consulte o estado do canal de saída de áudio. Você pode usar isso para determinar se deseja fazer seu caractere falar ou tentar ativar o modo de escuta (usando IAgentCharacterEx::Listen).