alcIsExtensionPresent

Aus DGL Wiki
Version vom 14. April 2008, 22:58 Uhr von Thoronador (Diskussion | Beiträge) (Konstantenname korrigiert)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

alcIsExtensionPresent

Name

alcIsExtensionPresent - Prüft, ob eine bestimmte OpenAL-Kontexterweiterung verfügbar ist.


Delphi-Spezifikation

function alcIsExtensionPresent(device: PALCdevice; const extName: PALCchar): TALCboolean;


Parameter

device Zeiger auf das Audiogerät, dessen Erweiterung abgefragt werden soll
extName Zeiger auf einen nullterminierten C-String, der die Erweiterung benennt


Beschreibung

Die Funktion alcIsExtensionPresent prüft, ob eine bestimmte Kontexterweiterung verfügbar ist. Falls die Erweiterung verfügbar ist, wird ALC_TRUE zurückgegeben; ist die Erweiterung nicht verfügbar, so wird ALC_FALSE zurückgegeben. Ungültige und nicht unterstützte Strings resultieren in ALC_FALSE als Rückgabewert. Der nil-Zeiger ist für device ein zulässiger Wert. Hingegen verursacht nil bei extName einen Fehler (ALC_INVALID_VALUE) und der Rückgabewert ist dann ALC_FALSE. Bei extName wird nicht zwischen Groß- und Kleinschreibung unterschieden, die Implementation wandelt den Namen intern in Großbuchstaben um.


Hinweise

Falls bei der Auführung ein Fehler auftritt, kann dieser mit alcGetError erfragt werden.


Fehlermeldungen

ALC_INVALID_VALUE wird generiert, wenn der Stringzeiger ungültig ist.


Zugehörige Wertrückgaben

alcGetString mit Token ALC_EXTENSIONS


Siehe auch

alcGetEnumValue, alcGetProcAddress