alcGetEnumValue
Inhaltsverzeichnis
alcGetEnumValue
Name
alcGetEnumValue - Gibt den Wert eines durch einen String beschriebenen TALCenum-Wertes zurück.
Delphi-Spezifikation
function alcGetEnumValue(device: PALCdevice; enumName: PALCchar): TALCenum;
Parameter
| device | Zeiger auf das Audiogerät, für das der Wert erfragt wird |
|---|---|
| enumName | Zeiger auf eine nullterminierte Zeichenkette, die den TALCenum-Wert beschreibt |
Beschreibung
Die Funktion alcGetEnumValue gibt den TALCenum-Wert des durch die Zeichenkette enumName beschriebenen Tokens zurück. Meist wird diese Funktion benutzt, um TALCenum-Werte einer Erweiterung abzufragen. Die Token-Werte sind geräteunabhängig, jedoch können bestimmte durch eine Erweiterung definierte Werte für ein gegebenes Gerät nicht verfügbar sein. Für device den nil-Zeiger zu benutzen, ist erlaubt, jedoch sind so nur die durch den AL-Kern definierten Tokenwerte auch garantiert. Die Verfügbarkeit der Token hängt von der ALC-Erweiterung ab. Falls für enumName der nil-Zeiger angegeben wird, verursacht dies einen Fehler (ALC_INVALID_VALUE) und der Rückgabewert ist AL_NONE (was dem Wert 0 entspricht).
Hinweise
Tritt bei der Ausführung ein Fehler auf, so kann dieser mit alcGetError erfragt werden.
Fehlermeldungen
ALC_INVALID_VALUE wird generiert, wenn der Zeiger auf den String ungültig/nil ist.
