alutGetMIMETypes

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alutGetMIMETypes

Name

alutGetMIMETypes - Gibt eine Liste der unterstützten Audioformate zurück.


Delphi-Spezifikation

function alutGetMIMETypes(loader: TALenum): PChar;


Parameter

loader Symbolische Konstante, welche die Art der Loader-Funktion angibt und eine der folgenden ist:

ALUT_LOADER_BUFFER
ALUT_LOADER_MEMORY


Beschreibung

Die Funktion alutGetMIMETypes gibt eine durch Kommata getrennte Liste der unterstützten MIME-Typen der angegebenen Loader-Funktionen zurück, was dann z.B. so aussehen könnte: "audio/basic,audio/mpeg,audio/x-wav". Zulässige Typen der Loader-Funktionen sind ALUT_LOADER_BUFFER für Funktionen, welche die Audiodaten in Form eines OpenAL-Puffers zurückgeben wie z.B. alutCreateBufferFromFile und alutCreateBufferFromFileImage sowie ALUT_LOADER_MEMORY für Funktionen, welche die Audiodaten in einer neu allokierten Speicherregion zurückgeben wie z.B. alutLoadMemoryFromFile und alutLoadMemoryFromFileImage. Es ist möglich, dass ALUT_LOADER_MEMORY-Funktionen nicht in der Lage sind, einige Formate zu unterstützen, welche durch die ALUT_LOADER_BUFFER-Funktionen unterstützt werden (jedoch ist der umgekehrte Fall ausgeschlossen). Weiterhin ist es möglich, dass für einige Dateitypen, speziell audio/x-wav, nur einige Unterformate unterstützt werden. So kann die Implementierung zum Beispiel angeben, dass audio/x-wav unterstützt wird, obwohl tatsächlich nur die unkomprimierten PCM-Wave-Dateien unterstützt werden und keines der komprimierten Unterformate. In so einem Fall können die verschiedenen ALUT-Loaderfunktionen einen Fehler erzeugen und den ALUT_ERROR_UNSUPPOERTED_FILE_SUBTYPE-Fehlerstatus setzen anstelle von ALUT_ERROR_UNSUPPOERTED_FILE_TYPE, was darauf hindeuten würde, dass überhaupt keine Dateien dieses Formats unterstützt werden.
Im Erfolgsfall gibt alutGetMIMETypes einen Zeiger auf einen nullterminierten String zurück, welcher eine durch Kommas getrennte Liste der unterstützten MIME-Typen enthält. Bei Fehlschlag wird nil zurückgegeben.


Hinweise

Falls bei der Ausführung von alutGetMIMETypes ein Fehler auftritt, so kann dieser mit alutGetError erfragt werden.


Fehlermeldungen

ALUT_ERROR_AL_ERROR_ON_ENTRY wird generiert, sofern beim Aufruf der Funktion schon ein AL-Fehlerstatus vorhanden war. (Siehe auch alGetError.)

ALUT_ERROR_ALC_ERROR_ON_ENTRY wird generiert, falls beim Aufruf der Funktion schon ein ALC-Fehlerstatus vorhanden war. (Siehe auch alcGetError.)

ALUT_ERROR_INVALID_ENUM wird generiert, wenn ein ungültiger Parameter an die Funktion übergeben wurde.

ALUT_ERROR_INVALID_OPERATION wird generiert, falls ALUT nicht initialisiert wurde.

ALUT_ERROR_NO_CURRENT_CONTEXT wird generiert, sofern es keinen aktuellen AL-Kontext gibt. (Siehe auch alcGetCurrentContext.)


Siehe auch

alutCreateBufferFromFile, alutCreateBufferFromFileImage, alutLoadMemoryFromFile, alutLoadMemoryFromFileImage