alcCaptureOpenDevice
Inhaltsverzeichnis
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.
