alcGetString - Versionsgeschichte

Thoronador: Typen in Delphispezifikation korrigiert

2008-04-12T19:31:24Z

Typen in Delphispezifikation korrigiert

Thoronador: Link zu "Null-terminiert" hinzugefügt

2008-03-29T14:53:08Z

Link zu "Null-terminiert" hinzugefügt

Thoronador: Die Seite wurde neu angelegt: = alcGetString = == Name == '''alcGetString''' - Liefert eine kontextspezifische Stringeigenschaft. == Delphi-Spezifikation == function '''alcGetString'''(''devi...

2008-03-28T03:17:01Z

Die Seite wurde neu angelegt: = alcGetString = == Name == '''alcGetString''' - Liefert eine kontextspezifische Stringeigenschaft. == Delphi-Spezifikation == function '''alcGetString'''(''devi...

Neue Seite

= alcGetString =

== Name ==
'''alcGetString''' - Liefert eine kontextspezifische Stringeigenschaft.

== Delphi-Spezifikation ==
function '''alcGetString'''(''device'':TALCdevice; ''param'': TALCenum): PALCubyte;

== Parameter ==

{| border="1" rules="all"
! ''device''
| Geräte, 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]]

[[Kategorie:AL|GetString]]
[[Kategorie:ALC|GetString]]

@@ Zeile 9: / Zeile 9: @@
 == Delphi-Spezifikation ==
-  function '''alcGetString'''(''device'':TALCdevice; ''param'': TALCenum): PALCubyte;
+  function '''alcGetString'''(''device'': PALCdevice; ''param'': TALCenum): PALCchar;
@@ Zeile 17: / Zeile 17: @@
 {| border="1" rules="all"
 ! ''device''
-| Geräte, dessen Eigenschaft abgefragt wird
+| Zeiger auf das Gerät, dessen Eigenschaft abgefragt wird
 |-
 ! ''param''

@@ Zeile 26: / Zeile 26: @@
 == 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:
@@ Zeile 40: / Zeile 40: @@
 === 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 ===
-: 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 ===