alutLoadMemoryHelloWorld
Inhaltsverzeichnis
alutLoadMemoryHelloWorld
Name
alutLoadMemoryHelloWorld - Lädt einen "Hello, world!"-Sound in den Speicher.
Delphi-Spezifikation
function alutLoadMemoryHelloWorld(format: PALenum; size: PALsizei; frequency: PALfloat): PALvoid;
Parameter
| format | Zeiger auf einen TALenum-Wert, in welchem das Format der Audiodaten abgelegt wird |
|---|---|
| size | Zeiger auf einen TALsizei-Wert, in welchem die Größe der Speicherregion gespeichert werden soll |
| frequency | Zeiger auf einen TALfloat, in welchem die Samplefrequenz der Audiodaten angegeben wird |
Beschreibung
Die Funktion alutLoadMemoryHelloWorld lädt die Audiodaten, wie jemand "Hello, world!" sagt, in einen neu angelegten Puffer. Es ist sichergestellt, dass Audiodaten in einem Standardformat der OpenAL vorliegen und eine von der ALUT-Implementierung bestimmte Samplefrequenz haben. Bei Erfolg gibt die Funktion einen Zeiger auf den neu angelegten Speicherbereich zurück, welcher die Audiodaten enthält. Der Speicherbereich kann von der Anwendung freigegeben werden, sobald die darin enthaltenen Daten nicht mehr benötigt werden. Schlägt die Funktion fehl, so wird nil zurückgegeben. Falls einer (oder mehrere) der Parameter format, size oder frequency kein nil-Zeiger ist, so wird die entsprechende Information über die Audiodaten zurückgegeben.
Hinweise
Falls bei der Ausführung ein Fehler auftritt, kann dieser mit alutGetError erfragt werden.
Alternativ kann man auch die Funktion alutCreateBufferHelloWorld benutzen, welche einen entsprechenden Sound gleich in einen AL-Puffer lädt.
Fehlermeldungen
ALUT_ERROR_AL_ERROR_ON_ENTRY wird generiert, wenn beim Aufruf der Funktion bereits ein AL-Fehlerstatus vorhanden war. (Siehe auch alGetError.)
ALUT_ERROR_ALC_ERROR_ON_ENTRY wird generiert, sofern beim Aufruf der Funktion bereits ein ALC-Fehlerstatus vorhanden war. (Siehe auch alcGetError.)
ALUT_ERROR_INVALID_OPERATION wird generiert, falls ALUT nicht initialisiert wurde. (Siehe auch alutInit.)
ALUT_ERROR_NO_CURRENT_CONTEXT wird generiert, sofern es keinen aktuellen OpenAL-Kontext gibt. (Siehe auch alcMakeContextCurrent.)
ALUT_ERROR_OUT_OF_MEMORY wird generiert, wenn nicht genügend Speicher zur Verfügung steht.
