In principle I agree that the documentation should be aligned with the
implementations. However I'm not sure that there is a problem. You cite
UInt32 suggestedLatencyFrames = inputParameters->suggestedLatency *
In general, this value is used as input to additional heuristics that
take framesPerBuffer and native API buffer size parameters into account
and *then* round-up. So the truncation in the above line makes little or
no difference to the final rounding-up.
In other words "suggestedLatencyFrames" is not typically the "next
practical value" that the documentation is referring to.
I write this mail because I opened the ticket as an anonymous user, so
if needed I can clarify /discuss the issue.