alGetError

alGetError

alGetError

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.

'