Update performance_hint to follow NDK API guidance

This patch updates the performance_hint NDK in response to API guidance,
and updates the tests accordingly.

Additionally, this patch updates the documentation and ergonomics of a
few related methods to better accomodate these changes, and to downgrade
going over the graphics pipeline limit from a breakage to a very severe
warning.

Flag: EXEMPT NDK
Test: atest
cts/tests/tests/os/src/android/os/cts/PerformanceHintManagerTest.java
Test: atest PerformanceHintNativeTestCases
Test: atest HintManagerServiceTest
Bug: 380299912
Bug: 381269529

Change-Id: I31f1c1db4ee4846a8aca63243f61ac1672aac309