Grafika komputerowa: SDL_GetAudioDeviceName

Użyj tej funkcji, aby otrzymać nazwę określonego urządzenia dźwiękowego.

Składnia

const char* SDL_GetAudioDeviceName(int index,
                                   int iscapture)

Parametry funkcji

index	indeks urządzenia dźwiękowego; wartości przebiegają od 0 do SDL_GetNumAudioDevices() - 1.
iscapture	wartość niezerowa, aby określić urządzenie dźwiękowe z funkcją nagrywania.

Wartość zwracana

Zwraca nazwę urządzenia dźwiękowego lub NULL przy błędzie; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Przykładowy kod

int i, count = SDL_GetNumAudioDevices(0);

for (i = 0; i < count; ++i)
{
    SDL_Log("Audio device %d: %s", i, SDL_GetAudioDeviceName(i, 0));
}

Uwagi

Funkcja ta jest ważna tylko po zainicjowaniu z sukcesem podsystemu audio. Wartości zwracane przez tę funkcję odzwierciedlają ostatnie wywołanie SDL_GetNumAudioDevices(); wywołaj ponownie tę funkcję, aby od nowa wykryć dostępny sprzęt.

Łańcuch tekstowy zwracany przez funkcję jest kodowany w UTF-8, tylko do odczytu i zarządzany wewnętrznie. Nie masz go zwalniać. Jeśli chcesz przechować ten łańcuch przez jakiś czas, powinieneś wykonać sobie jego kopię, ponieważ stanie się on nieaktualny po wywołaniu innych funkcji SDL.

Powiązane funkcje

SDL_GetNumAudioDevices

do podrozdziału do strony

Materiały tylko do użytku dydaktycznego. Ich kopiowanie i powielanie jest dozwolone pod warunkiem podania źródła oraz niepobierania za to pieniędzy.
Pytania proszę przesyłać na adres email: i-lo@eduinf.waw.pl
Serwis wykorzystuje pliki cookies. Jeśli nie chcesz ich otrzymywać, zablokuj je w swojej przeglądarce.

Informacje dodatkowe.