Thoronador: Die Seite wurde neu angelegt: = alutGetError = == Name == '''alutGetError''' - Liefert den Fehlerstatus von ALUT zurück. == Delphi-Spezifikation == function '''alutGetError''': TALenum; ...

2008-04-16T15:18:52Z

Die Seite wurde neu angelegt: = alutGetError = == Name == '''alutGetError''' - Liefert den Fehlerstatus von ALUT zurück. == Delphi-Spezifikation == function '''alutGetError''': TALenum; ...

Neue Seite

= 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:

{|border="1" rules="all"
! '''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]])

[[Kategorie:ALUT|GetError]]

alutGetError - Versionsgeschichte

Thoronador: Die Seite wurde neu angelegt: = alutGetError = == Name == '''alutGetError''' - Liefert den Fehlerstatus von ALUT zurück. == Delphi-Spezifikation == function '''alutGetError''': TALenum; ...