alcGetString: Unterschied zwischen den Versionen
Aus DGL Wiki
(Die Seite wurde neu angelegt: = alcGetString = == Name == '''alcGetString''' - Liefert eine kontextspezifische Stringeigenschaft. == Delphi-Spezifikation == function '''alcGetString'''(''devi...) |
K (Typen in Delphispezifikation korrigiert) |
||
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
| Zeile 9: | Zeile 9: | ||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| − | function '''alcGetString'''(''device'': | + | function '''alcGetString'''(''device'': PALCdevice; ''param'': TALCenum): PALCchar; |
| Zeile 17: | Zeile 17: | ||
{| border="1" rules="all" | {| border="1" rules="all" | ||
! ''device'' | ! ''device'' | ||
| − | | | + | | Zeiger auf das Gerät, dessen Eigenschaft abgefragt wird |
|- | |- | ||
! ''param'' | ! ''param'' | ||
| Zeile 26: | Zeile 26: | ||
== Beschreibung == | == 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. | + | Die Funktion '''alcGetString''' liefert einen Zeiger auf einen [[Null-terminiert|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: | Folgende Werte sind für ''param'' zugelassen: | ||
| Zeile 40: | Zeile 40: | ||
=== ALC_DEVICE_SPECIFIER === | === 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. | + | : Falls für ''device'' ein Ausgabegerät angegeben ist, wird ein Zeiger auf einen [[Null-terminiert|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 === | === 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. | + | : Gibt einen Zeiger auf einen [[Null-terminiert|null-terminierten]] String zurück, der alle verfügbaren Kontexterweiterungen beinhaltet. Die einzelnen Erweiterungen sind jeweils durch ein Leerzeichen getrennt. |
=== Weitere symbolische Konstanten === | === Weitere symbolische Konstanten === | ||
Aktuelle Version vom 12. April 2008, 20:31 Uhr
Inhaltsverzeichnis
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.
