alcCaptureOpenDevice

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alcCaptureOpenDevice

Name

alcCaptureOpenDevice - Öffnet ein Audioaufnahmegerät.


Delphi-Spezifikation

function alcCaptureOpenDevice(const devicename: PALCchar; frequency: TALCuint; format: TALCenum; buffersize: TALCsizei) : PALCdevice;


Parameter

devicename Zeiger auf einen nullterminierten String, der den Gerätenamen angibt.
frequency Frequenz, bei der die Daten aufgenommen werden sollen
format Format des Aufnahmepuffers
buffersize Größe des Aufnahmepuffers


Beschreibung

Die Funktion alcCaptureOpenDevice öffnet das Audioaufnahmegerät mit dem Namen devicename und gibt einen Zeiger auf das geöffnete Geräte zurück. Falls kein entsprechendes Audiogerät gefunden werden konnte, oder falls das angegebene Format nicht erfüllt werden kann, wird nil zurückgegeben.

Wird für devicename der nil-Zeiger angegeben, so wird ein implementationsabhängiges Standardgerät geliefert. Die Parameter frequency und format spezifizieren das Format, in dem die Audiodaten an die Anwendung weitergereicht werden und entsprechen den Werten, die auch an alBufferData übergeben werden können. Der Wert von buffersize gibt die Anzahl der Sampleframes an, die in der AL gepuffert werden sollen. Zum Beispiel werden, falls das Format mit AL_FORMAT_STEREO16 und die Puffergöße buffersize mit 1024 angegeben ist, bis zu 1024 * 4 Bytes Audiodaten von der AL gespeichert. Die Implementation wird im Bedarfsfall möglicherweise einen größeren Puffer anlegen, als angefordert wurde, jedoch wird die Implementation einen Puffer von mindestens der angeforderten Größe anlegen.


Hinweise

Die Angabe eines komprimierten oder durch Extensions unterstützten Formates kann einen Fehlschlag verursachen, selbst wenn die Wiedergabe des angegebenen Formats unterstützt wird.


Änderungen

Folgende Erweiterungen hat die Funktion erfahren:

Ab OpenAL-Version 1.1

Die Funktion alcCaptureOpenDevice ist erst ab OpenAL-Version 1.1 verfügbar.

Die OpenAL-Erweiterung ALC_EXT_CAPTURE, welche von einer Implementation der OpenAL Version 1.1 immer unterstützt wird, erlaubt jedoch einer für die Spezifikation von OpenAL 1.0 geschriebenen Anwendung, die auf eine Bibliothek der Version 1.1 verlinkt, auch auf die Funktion alcCaptureOpenDevice zuzugreifen.


Fehlermeldungen

ALC_INVALID_VALUE wird generiert, wenn mindestens einer der Parameter einen unzulässigen Wert hat.

ALC_OUT_OF_MEMORY wird generiert, falls das angegebene Gerät ungültig ist oder keine Audiodaten aufzeichnen kann.


Zugehörige Wertrückgaben

alcGetString mit Token ALC_CAPTURE_DEVICE_SPECIFIER und nil als device-Parameter gibt eine Liste der verfügbaren Aufnahmegeräte zurück.


Siehe auch

alcCaptureCloseDevice