Condividi tramite

IAgentAudioOutputPropertiesEx::GetStatus

  • Articolo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

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

Recupera lo stato del canale audio.

  • Restituisce S_OK per indicare che l'operazione è stata completata correttamente.

plStatus

Stato del canale di output audio, che può essere uno dei valori seguenti:

valore Descrizione
const unsigned short AUDIO_STATUS_AVAILABLE = 0;
 Il canale di output audio è disponibile (non occupato).
const unsigned short AUDIO_STATUS_NOAUDIO = 1;
 Non è disponibile alcun supporto per l'output audio; ad esempio, perché non è presente alcuna scheda audio.
const unsigned short AUDIO_STATUS_CANTOPENAUDIO = 2;
 Il canale di output audio non può essere aperto (è occupato); ad esempio, perché un'altra applicazione sta riproducendo audio.
const unsigned short AUDIO_STATUS_USERSPEAKING = 3;
 Il canale di output audio è occupato perché il server sta elaborando l'input vocale dell'utente
const unsigned short AUDIO_STATUS_CHARACTERSPEAKING = 4;
 Il canale di output audio è occupato perché un carattere sta attualmente parlando.
const unsigned short AUDIO_STATUS_SROVERRIDEABLE = 5;
 Il canale di output audio non è occupato, ma è in attesa dell'input vocale dell'utente.
const unsigned short AUDIO_STATUS_ERROR = 6;
 C'è stato un altro problema (sconosciuto) nel tentativo di accedere al canale di output audio.

Questa impostazione consente all'applicazione client di eseguire una query sullo stato del canale di output audio. È possibile usarlo per determinare se avere il carattere parlare o provare a attivare la modalità di ascolto (usando IAgentCharacterEx::Listen).