alcGetIntegerv
Inhaltsverzeichnis
alcGetIntegerv
Name
alcGetIntegerv - Liefert Ganzzahlwerte für einen Kontext zurück.
Delphi-Spezifikation
procedure alGetIntegerv(device: PALCdevice; param: TALCenum; size: TALsizei; data: PALCint);
Parameter
| device | Zeiger auf das abzufragende Gerät |
|---|---|
| param | Symbolische Konstante, welche den Wert bestimmt, der zurückgeliefert wird |
| size | Größe des bereitgestellten Puffers data (in TALCint-Werten) |
| data | Zeiger auf die zurückzugebenden Daten |
Beschreibung
alcGetIntegerv gibt eine auf den ALC-Kontext bezogene Ganzzahleigenschaft zurück. Welche Werte zurückgegeben werden, wird durch param näher bestimmt.
Folgende symbolische Konstanten sind für param zulässig:
ALC_ALL_ATTRIBUTES
- Gibt die Attributsliste des aktuellen Kontexts des angegebenen Gerätes device zurück. Dabei wird erwartet, dass der über den Zeiger data erreichbare Puffer die Größe hat, welche man durch einen Aufruf von alcGetIntegerv mit der symbolischen Konstante ALC_ATTRIBUTE_SIZE erhalten kann. Der nil-Zeiger ist kein zulässiger Wert für device.
ALC_ATTRIBUTE_SIZE
- Die Größe (Anzahl der TALCint-Werte), welche für eine null-terminierte Attributsliste des aktuellen Kontexts benötigt wird. wird zurückgegeben. Der nil-Zeiger ist kein zulässiger Wert für device.
ALC_CAPTURE_SAMPLES
- Gibt die Anzahl der verfügbaren Aufnahmesamples zurück. Hierbei sollte device ein Aufnahmegerät sein, nil ist kein zulässiger Wert für device.
ALC_MAJOR_VERSION
- Gibt die Hauptversion der ALC-Implementierung zurück. nil ist ein zulässiger Wert für device.
ALC_MINOR_VERSION
- Gibt die Nebenversion der ALC-Implementierung zurück. Hierbei ist nil ein zulässiger Wert für device.
Hinweise
Die Anwendung muss die Größe des Zielpuffers data (als Anzahl von TALCint-Elementen) im Parameter size angeben. Sofern size den Wert null hat oder wenn data der nil-Zeiger ist, dann tut die Funktion nichts.
Falls bei der Ausführung von alcGetIntegerv ein Fehler auftritt, kann dieser mit alcGetError erfragt werden.
Fehlermeldungen
ALC_INVALID_CONTEXT wird generiert, sofern der angegebene Kontext unzulässig ist.
ALC_INVALID_DEVICE wird generiert, wenn das angegebene Gerät unzulässig ist.
ALC_INVALID_ENUM wird generiert, wenn der angegebene Parameter unzulässig ist.
ALC_INVALID_VALUE wird generiert, falls der Zeiger data unzulässig ist oder die Größe ungültig ist.
