IAgentAudioOutputPropertiesEx::GetStatus

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

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

Ruft den Status des Audiokanals ab.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

plStatus

Status des Audioausgabekanals, bei dem es sich um einen der folgenden Werte handeln kann:

Wert	Beschreibung
const unsigned shortAUDIO_STATUS_AVAILABLE = 0;	Der Audioausgabekanal ist verfügbar (nicht ausgelastet).
const unsigned shortAUDIO_STATUS_NOAUDIO = 1;	Eine Unterstützung für die Audioausgabe gibt es nicht, da beispielsweise keine Soundkarte vorhanden ist.
const unsigned shortAUDIO_STATUS_CANTOPENAUDIO = 2;	Der Audioausgabekanal kann nicht geöffnet werden (ist ausgelastet), da beispielsweise eine andere Anwendung Audio wiedergibt.
const unsigned shortAUDIO_STATUS_USERSPEAKING = 3;	Der Audioausgabekanal ist ausgelastet, da der Server die Spracheingabe des Benutzers verarbeitet.
const unsigned shortAUDIO_STATUS_CHARACTERSPEAKING = 4;	Der Audioausgabekanal ist ausgelastet, da gerade ein Charakter spricht.
const unsigned shortAUDIO_STATUS_SROVERRIDEABLE = 5;	Der Audioausgabekanal ist nicht ausgelastet, wartet jedoch auf die Spracheingabe des Benutzers.
const unsigned shortAUDIO_STATUS_ERROR = 6;	Es gab ein anderes (unbekanntes) Problem beim Versuch, auf den Audioausgabekanal zuzugreifen.

Mit dieser Einstellung kann Ihre Clientanwendung den Status des Audioausgabekanals abfragen. Damit können Sie festlegen, ob Ihr Charakter sprechen soll oder ob Sie versuchen möchten, den Listening-Modus einzuschalten (mit IAgentCharacterEx::Listen).