https://wiki.delphigl.com/index.php?action=history&feed=atom&title=alcCaptureOpenDevice 2026-05-25T00:05:23Z Versionsgeschichte dieser Seite in DGL Wiki MediaWiki 1.27.4 https://wiki.delphigl.com/index.php?title=alcCaptureOpenDevice&diff=21831&oldid=prev 2008-06-04T22:52:27Z

<p>Die Seite wurde neu angelegt: = alcCaptureOpenDevice = == Name == &#039;&#039;&#039;alcCaptureOpenDevice&#039;&#039;&#039; - Öffnet ein Audioaufnahmegerät. == Delphi-Spezifikation == function &#039;&#039;&#039;alcCaptureOpenDevice&#039;&#039;&#039;(...</p> <p><b>Neue Seite</b></p><div>= alcCaptureOpenDevice =<br /> <br /> <br /> <br /> == Name ==<br /> '''alcCaptureOpenDevice''' - Öffnet ein Audioaufnahmegerät.<br /> <br /> <br /> <br /> == Delphi-Spezifikation ==<br /> function '''alcCaptureOpenDevice'''(const ''devicename'': PALCchar; ''frequency'': TALCuint; ''format'': TALCenum; ''buffersize'': TALCsizei) : PALCdevice;<br /> <br /> <br /> <br /> == Parameter ==<br /> <br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''devicename'' <br /> | Zeiger auf einen [[Null-terminiert|nullterminierten]] String, der den Gerätenamen angibt.<br /> |-<br /> ! ''frequency'' <br /> | Frequenz, bei der die Daten aufgenommen werden sollen<br /> |-<br /> ! ''format'' <br /> | Format des Aufnahmepuffers<br /> |-<br /> ! ''buffersize'' <br /> | Größe des Aufnahmepuffers<br /> |}<br /> <br /> <br /> <br /> == Beschreibung == <br /> 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.<br /> <br /> 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.<br /> <br /> <br /> <br /> == Hinweise ==<br /> Die Angabe eines komprimierten oder durch Extensions unterstützten Formates kann einen Fehlschlag verursachen, selbst wenn die Wiedergabe des angegebenen Formats unterstützt wird.<br /> <br /> <br /> <br /> == Änderungen ==<br /> Folgende Erweiterungen hat die Funktion erfahren:<br /> === Ab OpenAL-Version 1.1 ===<br /> Die Funktion '''alcCaptureOpenDevice''' ist erst ab OpenAL-Version 1.1 verfügbar.<br /> <br /> 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.<br /> <br /> <br /> == Fehlermeldungen ==<br /> '''ALC_INVALID_VALUE''' wird generiert, wenn mindestens einer der Parameter einen unzulässigen Wert hat.<br /> <br /> '''ALC_OUT_OF_MEMORY''' wird generiert, falls das angegebene Gerät ungültig ist oder keine Audiodaten aufzeichnen kann.<br /> <br /> <br /> <br /> == Zugehörige Wertrückgaben ==<br /> [[alcGetString]] mit Token [[alcGetString#ALC_CAPTURE_DEVICE_SPECIFIER|ALC_CAPTURE_DEVICE_SPECIFIER]] und '''nil''' als ''device''-Parameter gibt eine Liste der verfügbaren Aufnahmegeräte zurück.<br /> <br /> <br /> <br /> == Siehe auch ==<br /> [[alcCaptureCloseDevice]]<br /> <br /> [[Kategorie:AL|CaptureOpenDevice]]<br /> [[Kategorie:ALC|CaptureOpenDevice]]</div>

Thoronador