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
Bug: 384511707
Bug: 384738612

Change-Id: Ie885112368bec7cfa9dc527de2bf1fef3475594d