.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL's wiki page for SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES:
.\"   https://wiki.libsdl.org/SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES
.\" SDL can be found at https://libsdl.org/
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES 3 "SDL 3.2.5" "Simple Directmedia Layer" "SDL3 FUNCTIONS"
.SH NAME
SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES \- A variable controlling device buffer size\[char46]
.SH HEADER FILE
Defined in SDL3/SDL_hints\[char46]h

.SH SYNOPSIS
.nf
.B #include \(dqSDL3/SDL.h\(dq
.PP
.BI "#define SDL_HINT_AUDIO_DEVICE_SAMPLE_FRAMES "SDL_AUDIO_DEVICE_SAMPLE_FRAMES"
.fi
.SH DESCRIPTION
This hint is an integer > 0, that represents the size of the device's
buffer in sample frames (stereo audio data in 16-bit format is 4 bytes per
sample frame, for example)\[char46]

SDL3 generally decides this value on behalf of the app, but if for some
reason the app needs to dictate this (because they want either lower
latency or higher throughput AND ARE WILLING TO DEAL WITH what that might
require of the app), they can specify it\[char46]

SDL will try to accommodate this value, but there is no promise you'll get
the buffer size requested\[char46] Many platforms won't honor this request at all,
or might adjust it\[char46]

This hint should be set before an audio device is opened\[char46]

.SH AVAILABILITY
This hint is available since SDL 3\[char46]2\[char46]0\[char46]