alutGetError

Aus DGL Wiki
Wechseln zu: Navigation, Suche

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)