int SDL_QueueAudio(SDL_AudioDeviceID dev,
                   const void*       data,
                   Uint32            len)

Zwraca 0 przy sukcesie lub ujemny kod błędu przy niepowodzeniu; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Jeśli chcesz pobrać dane dźwiękowe z urządzenia nagrywającego, które nie posługuje się funkcją wywoływaną zwrotnie, to będzie ci potrzebna funkcja SDL_DequeueAudio(). Funkcja SDL_QueueAudio() zwróci wartość -1, aby poinformować o błędzie, jeśli użyjesz jej dla urządzeń nagrywających.

SDL oferuje dwa sposoby przesyłania danych dźwiękowych do urządzenia: możesz albo dostarczyć funkcję wywoływaną zwrotnie, którą SDL będzie wyzwalało z pewną częstotliwością w celu pobrania więcej dźwięku (metoda pull), albo nie dostarczasz takiej funkcji, a wtedy SDL będzie oczekiwać od ciebie udostępniania danych w regularnych odstępach czasu (metoda push) za pomocą tej funkcji.

Nie ma ograniczeń co do ilości zakolejkowanych danych poza wyczerpaniem dostępnej pamięci. Zakolejkowane dane będą w razie potrzeby przesyłane kolejno do urządzenia bez dalszej interwencji z twojej strony. Jeśli urządzenie będzie potrzebowało więcej danych dźwiękowych, niż zostało umieszczone w kolejce, zacznie odtwarzać ciszę. Oznacza to, iż otrzymasz wtedy przerwy w odtwarzaniu dźwięku, jeśli rutynowo nie zakolejkujesz wystarczającej ilości danych.

Ta funkcja kopiuje dostarczone dane, zatem gdy nastąpi powrót, możesz je usuwać z pamięci. Funkcja jest bezpieczna wątkowo, lecz kolejkowanie z dwóch wątków do tego samego urządzenia nie daje żadnych gwarancji, który z buforów będzie zakolejkowany najpierw.

Nie wolno kolejkować dźwięku na urządzeniu, które wykorzystuje dostarczoną przez aplikację funkcję wywoływaną zwrotnie; jęli będziesz tego próbował, funkcja zwróci błąd. Musisz użyć albo kolejki, albo funkcji callback, ale nie obu metod jednocześnie.

Nie powinieneś wywoływać SDL_LockAudio()dla urządzenia przed kolejkowaniem; SDL obsługuje blokowanie wewnętrznie dla tej funkcji.

Funkcja dostępna od SDL 2.0.4.

SDL_ClearQueuedAudio
SDL_GetQueuedAudioSize