alGetError
Inhaltsverzeichnis
alGetError
Name
alGetError - Liefert den gegenwärtigen Fehlerstatus von OpenAL.
Delphi-Spezifikation
function alGetError: TALenum;
Parameter
Keine.
Beschreibung
Die Funktion gibt den aktuellen Fehlerstatus zurück und löscht diesen dann.
Rückgabewerte, anhand deren der Fehler näher bestimmt werden kann, können folgende sein:
| AL_NO_ERROR | Seit dem letzten Aufruf der Funktion (oder, sofern die Funktion noch nicht aufgerufen wurde, seit dem Start von AL) ist kein Fehler aufgetreten. |
|---|---|
| AL_INVALID_NAME | Ungültiger Namensparameter |
| AL_INVALID_ENUM | Ungültiger Parameter |
| AL_INVALID_VALUE | Ungültiger enum-Parameterwert |
| AL_INVALID_OPERATION | Ungültiger Funktions-/Prozeduraufruf |
| AL_OUT_OF_MEMORY | Es konnte nicht genügend Speicher allokiert werden, um die Funktion/ Prozedur auszuführen. |
Hinweise
Die Funktion gibt einen TALenum-Wert zurück, welcher den aktuellen Fehlerstatus wiedergibt. Sobald ein OpenAL-Fehler auftritt, wird der Fehlerstatus gesetzt und wird nicht geändert bis der Fehlerstatus mit alGetError abgefragt wird. Wann immer alGetError aufgerufen wird, wird der Fehlerstatus gelöscht und der letzte Zustand (d.h. der aktuelle Zustand zum Zeitpunkt des Funktionsaufrufes) wird zurückgegeben. Um den Fehler in einem bestimmten Codeabschnitt zu detektieren, sollte alGetError also einmal vor dem entsprechenden Abschnitt aufgerufen werden, um den Fehlerstatus zu löschen
Fehlermeldungen
Diese Funktion generiert keine Fehler.
