alGetString

alGetString

Name

alGetString - Liefert eine OpenAL-Stringeigenschaft.

Delphi-Spezifikation

function alGetString(param: TALenum): PALubyte;

Parameter

param	Eigenschaft, welche zurückgegeben werden soll

Beschreibung

Die Funktion alGetString liefert eine Stringeigenschaft von OpenAL zurück. Der Rückgabewert ist ein Zeiger auf einen null-terminierten String.

Folgende Werte werden für param akzeptiert:

AL_EXTENSIONS

Eine Liste der verfügbaren Erweiterungen wird zurückgegeben, die einzelnen Erweiterungen sind durch Leerzeichen voneinander getrennt. Um auf einfachem Wege zu testen, ob eine bestimmte Erweiterung vorhanden ist, kann man auch die Funktion alIsExtensionPresent verwenden.

AL_RENDERER

Gibt den Namen des Renderers zurück.

AL_VENDOR

Der Name des Herstellers der OpenAL-Implementation wird zurückgegeben.

AL_VERSION

Die Version der OpenAL wird zurückgegeben. Diese hat normalerweise das Format "<Hauptversion>.<Nebenversion>" und kann anschließend eventuell noch herstellerspezifische Informationen enthalten.

Hinweise

Falls ein ungültiger Wert für param angegeben wird, gibt die Funktion einen nil-Zeiger zurück und der Fehler AL_INVALID_ENUM wird generiert. Der Fehler kann dann mit der Funktion alGetError erfragt werden.

Fehlermeldungen

AL_INVALID_ENUM wird generiert, wenn der angegebene Wert von param ungültig ist.

Siehe auch

alcGetString