alcGetString

Aus DGL Wiki
Version vom 12. April 2008, 20:31 Uhr von Thoronador (Diskussion | Beiträge) (Typen in Delphispezifikation korrigiert)

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

alcGetString

Name

alcGetString - Liefert eine kontextspezifische Stringeigenschaft.


Delphi-Spezifikation

function alcGetString(device: PALCdevice; param: TALCenum): PALCchar;


Parameter

device Zeiger auf das Gerät, dessen Eigenschaft abgefragt wird
param Symbolische Konstante, welche die zurückzugebende Eigenschaft bestimmt


Beschreibung

Die Funktion alcGetString liefert einen Zeiger auf einen null-terminierten String oder eine Reihe von null-terminierten Strings zurück. In letzterem Fall wird das Ende der Stringliste durch zwei aufeinanderfolgende Nullbytes gekennzeichnet.

Folgende Werte sind für param zugelassen:

ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER

Gibt den Namen des Standardaufnahmegerätes zurück. Sollte auf dem System kein Aufnahmegerät verfügbar sein, wird nil zurückgegeben.

ALC_CAPTURE_DEVICE_SPECIFIER

Falls für device ein Aufnahmegerät angegeben ist, wird der Name dieses Gerätes zurückgegeben. Wird stattdessen ein nil-Zeiger angegeben, so wird eine Liste aller verfügbaren Aufnahmegeräte zurückgeliefert. Die einzelnen Zeichenketten sind durch Nullbytes getrennt, die Liste selbst wird durch zwei aufeinanderfolgende Nullbytes beendet.

ALC_DEFAULT_DEVICE_SPECIFIER

Der Name des Standardausgabegerätes wird zurückgegeben. Auf einem System ohne Audioausgabegerät wird stattdessen ein nil-Zeiger zurückgegeben.

ALC_DEVICE_SPECIFIER

Falls für device ein Ausgabegerät angegeben ist, wird ein Zeiger auf einen null-terminierten String, welcher den Namen des Gerätes enthält, zurückgegeben. Wird für device jedoch ein nil-Zeiger angegeben, so wird ein Zeiger auf eine Liste aller verfügbaren Ausgabegeräte zurückgegeben. Die einzelnen Zeichenketten sind durch einen Nullbyte getrennt, die Liste selbst wird durch zwei aufeinanderfolgende Nullbytes beendet.

ALC_EXTENSIONS

Gibt einen Zeiger auf einen null-terminierten String zurück, der alle verfügbaren Kontexterweiterungen beinhaltet. Die einzelnen Erweiterungen sind jeweils durch ein Leerzeichen getrennt.

Weitere symbolische Konstanten

Für alle gültigen symbolischen Konstanten, die einen Fehlerstatus repräsentieren, sprich für ALC_INVALID_CONTEXT, ALC_INVALID_DEVICE, ALC_INVALID_ENUM, ALC_INVALID_VALUE und ALC_NO_ERROR , wird ein Zeiger auf eine Zeichenkette mit einer dazugehörigen Fehlermeldung zurückgegeben.

Hinweise

Falls beim Aufruf von alcGetString ein Fehler auftritt, kann dieser mit alcGetError abgefragt werden.


Fehlermeldungen

AL_INVALID_ENUM wird generiert, wenn der Paramter param ungültig ist.


Siehe auch

alGetString