IAgentAudioOutputPropertiesEx::GetStatus

[O Microsoft Agent foi preterido a partir do Windows 7 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 shortAUDIO_STATUS_AVAILABLE não assinado = 0;	O canal de saída de áudio está disponível (não ocupado).
const shortAUDIO_STATUS_NOAUDIO não assinado = 1;	Não há suporte para saída de áudio; por exemplo, porque não há placa de som.
const shortAUDIO_STATUS_CANTOPENAUDIO não assinado = 2;	O canal de saída de áudio não pode ser aberto (está ocupado); por exemplo, porque outro aplicativo está reproduzindo áudio.
const shortAUDIO_STATUS_USERSPEAKING não assinado = 3;	O canal de saída de áudio está ocupado porque o servidor está processando a entrada de fala do usuário
const shortAUDIO_STATUS_CHARACTERSPEAKING não assinado = 4;	O canal de saída de áudio está ocupado porque um personagem está falando no momento.
const shortAUDIO_STATUS_SROVERRIDEABLE não assinado = 5;	O canal de saída de áudio não está ocupado, mas está aguardando a entrada de fala do usuário.
const shortAUDIO_STATUS_ERROR não assinado = 6;	Houve algum outro problema (desconhecido) na tentativa de acessar o canal de saída de áudio.

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