alGetString: Unterschied zwischen den Versionen
Aus DGL Wiki
(Die Seite wurde neu angelegt: = alGetString = == Name == '''alGetString''' - Liefert eine OpenAL-Stringeigenschaft. == Delphi-Spezifikation == function '''alBefehl'''(''param'': TALenum): PAL...) |
K (→Delphi-Spezifikation) |
||
| (2 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
| Zeile 9: | Zeile 9: | ||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| − | function ''' | + | function '''alGetString'''(''param'': TALenum): PALubyte; |
| − | |||
| − | |||
== Parameter == | == Parameter == | ||
| Zeile 23: | Zeile 21: | ||
== Beschreibung == | == Beschreibung == | ||
| − | Die Funktion '''alGetString''' liefert eine Stringeigenschaft von OpenAL zurück. Der Rückgabewert ist ein Zeiger auf einen null-terminierten String. | + | Die Funktion '''alGetString''' liefert eine Stringeigenschaft von [[OpenAL]] zurück. Der Rückgabewert ist ein Zeiger auf einen [[Null-terminiert|null-terminierten]] String. |
Folgende Werte werden für ''param'' akzeptiert: | Folgende Werte werden für ''param'' akzeptiert: | ||
| Zeile 37: | Zeile 35: | ||
=== AL_VERSION === | === 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. | : Die Version der OpenAL wird zurückgegeben. Diese hat normalerweise das Format "<Hauptversion>.<Nebenversion>" und kann anschließend eventuell noch herstellerspezifische Informationen enthalten. | ||
| − | |||
| − | |||
== Hinweise == | == 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. | + | 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. |
| Zeile 47: | Zeile 43: | ||
== Fehlermeldungen == | == Fehlermeldungen == | ||
'''AL_INVALID_ENUM''' wird generiert, wenn der angegebene Wert von ''param'' ungültig ist. | '''AL_INVALID_ENUM''' wird generiert, wenn der angegebene Wert von ''param'' ungültig ist. | ||
| + | |||
| + | |||
| + | |||
| + | == Siehe auch == | ||
| + | [[alcGetString]] | ||
[[Kategorie:AL|GetString]] | [[Kategorie:AL|GetString]] | ||
Aktuelle Version vom 2. Januar 2014, 23:21 Uhr
Inhaltsverzeichnis
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.
