alutGetError

alutGetError

Name

alutGetError - Liefert den Fehlerstatus von ALUT zurück.

Delphi-Spezifikation

function alutGetError: TALenum;

Parameter

Diese Funktion hat keine Parameter.

Beschreibung

Die Funktion alutGetError liefert den aktuellen ALUT-Fehlerstatus zurück und löscht diesen dann. Jede ALUT-Routine, die fehlschlägt, wird AL_FALSE/ AL_NONE/ nil zurückgeben und den globalen Fehlerstatus setzen. Falls danach ein weiterer Fehler auftreten sollte, obwohl intern immer noch der Fehlerstatus gesetzt ist, wird der zweite Fehler von alutGetError einfach ignoriert. Ein Aufruf von alutGetError setzt den Fehlerstatus auf ALUT_ERROR_NO_ERROR zurück. Die Rückgabewerte von alutGetError, anhand derer der letzte Fehler näher bestimmt werden kann, können folgende sein:

ALUT_ERROR_NO_ERROR	Kein Fehler (seit dem letzten Aufruf der Funktion)
ALUT_ERROR_AL_ERROR_ON_ENTRY	Beim Aufruf der ALUT-Funktion war bereits ein AL-Fehlerstatus vorhanden. (Siehe alGetError.)
ALUT_ERROR_ALC_ERROR_ON_ENTRY	Beim Aufruf der ALUT-Funktion war bereits ein ALC-Fehlerstatus vorhanden. (Siehe alcGetError.)
ALUT_ERROR_BUFFER_DATA	Fehler beim Füllen eines Puffers mit Daten.
ALUT_ERROR_CLOSE_DEVICE	Fehler beim Schließen eines Gerätes
ALUT_ERROR_CORRUPT_OR_TRUNCATED_DATA	Die Audiodaten sind fehlerhaft.
ALUT_ERROR_CREATE_CONTEXT	Fehler beim Erstellen eines Kontexts
ALUT_ERROR_DESTROY_CONTEXT	Fehler beim Löschen eines ALC-Kontexts
ALUT_ERROR_GEN_BUFFERS	Fehler beim Erzeugen eines AL-Puffers
ALUT_ERROR_INVALID_ENUM	An ALUT wurde ein unzulässiger Token übergeben.
ALUT_ERROR_INVALID_OPERATION	Die Operation ist im gegenwärtigen ALUT-Zustand unzulässig.
ALUT_ERROR_INVALID_VALUE	An eine ALUT-Funktion wurde ein unzulässiger Wert übergeben.
ALUT_ERROR_IO_ERROR	Eingabe-/Ausgabe-Fehler
ALUT_ERROR_MAKE_CONTEXT_CURRENT	Der aktuelle ALC-Kontext konnte nicht gewechselt werden.
ALUT_ERROR_NO_CURRENT_CONTEXT	Es existiert kein aktueller Kontext.
ALUT_ERROR_OPEN_DEVICE	Fehler beim Öffnen eines Gerätes
ALUT_ERROR_OUT_OF_MEMORY	Für eine ALUT-Funktion stand nicht genügen Speicher zur Verfügung.
ALUT_ERROR_UNSUPPORTED_FILE_SUBTYPE	Ein Unterformat eines ansonsten unterstützten Dateityps wird nicht unterstützt.
ALUT_ERROR_UNSUPPORTED_FILE_TYPE	Der Dateityp wird nicht unterstützt.

Hinweise

Der Fehlerstatus wird durch einen erfolgreichen ALUT-Funktionsaufruf nicht gelöscht.

Es wird garantiert, dass eine Funktion, die fehlschlägt, keine Daten, auf welche an sie übergebene Zeigerargumente verweisen, ändert.

Fehlermeldungen

Die Funktion alutGetError kann in jedem Zustand der ALUT aufgerufen werden und wird niemals fehlschlagen.

Siehe auch

alutGetErrorString (evtl. auch alGetError, alcGetError)