alGetString: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Link zu "Null-terminiert" hinzugefügt)
K (Delphi-Spezifikation)
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 9: Zeile 9:
  
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
  function '''alBefehl'''(''param'': TALenum): PALubyte;
+
  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-terminiert|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 39: Zeile 37:
  
 
== 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 45: 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

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