|
200 | 200 | <tr class="separator:a9fdffea9e3a3f693fcbbbca699a22c6b"><td class="memSeparator" colspan="2"> </td></tr> |
201 | 201 | <tr class="memitem:a9cf8ce01c8db830f89b70c782fe18d90" id="r_a9cf8ce01c8db830f89b70c782fe18d90"><td class="memItemLeft" align="right" valign="top">virtual oboe::Result </td><td class="memItemRight" valign="bottom"><a class="el" href="#a9cf8ce01c8db830f89b70c782fe18d90">reportWorkload</a> (int32_t appWorkload)</td></tr> |
202 | 202 | <tr class="separator:a9cf8ce01c8db830f89b70c782fe18d90"><td class="memSeparator" colspan="2"> </td></tr> |
| 203 | +<tr class="memitem:aab76b523480d65f25f7df3c99f2dce47" id="r_aab76b523480d65f25f7df3c99f2dce47"><td class="memItemLeft" align="right" valign="top">virtual oboe::Result </td><td class="memItemRight" valign="bottom"><a class="el" href="#aab76b523480d65f25f7df3c99f2dce47">notifyWorkloadIncrease</a> (bool cpu, bool gpu, const char *debugName)</td></tr> |
| 204 | +<tr class="separator:aab76b523480d65f25f7df3c99f2dce47"><td class="memSeparator" colspan="2"> </td></tr> |
| 205 | +<tr class="memitem:a3625762def846a6f4b3f48548bfa1b9c" id="r_a3625762def846a6f4b3f48548bfa1b9c"><td class="memItemLeft" align="right" valign="top">virtual oboe::Result </td><td class="memItemRight" valign="bottom"><a class="el" href="#a3625762def846a6f4b3f48548bfa1b9c">notifyWorkloadReset</a> (bool cpu, bool gpu, const char *debugName)</td></tr> |
| 206 | +<tr class="separator:a3625762def846a6f4b3f48548bfa1b9c"><td class="memSeparator" colspan="2"> </td></tr> |
| 207 | +<tr class="memitem:a5124210a3410ab9e36ea4c4b8b30e7b1" id="r_a5124210a3410ab9e36ea4c4b8b30e7b1"><td class="memItemLeft" align="right" valign="top">virtual oboe::Result </td><td class="memItemRight" valign="bottom"><a class="el" href="#a5124210a3410ab9e36ea4c4b8b30e7b1">notifyWorkloadSpike</a> (bool cpu, bool gpu, const char *debugName)</td></tr> |
| 208 | +<tr class="separator:a5124210a3410ab9e36ea4c4b8b30e7b1"><td class="memSeparator" colspan="2"> </td></tr> |
203 | 209 | <tr class="memitem:aac81c2a3fd1ce1bd19e7b738553d6390" id="r_aac81c2a3fd1ce1bd19e7b738553d6390"><td class="memItemLeft" align="right" valign="top"><a id="aac81c2a3fd1ce1bd19e7b738553d6390" name="aac81c2a3fd1ce1bd19e7b738553d6390"></a> |
204 | 210 | virtual oboe::Result </td><td class="memItemRight" valign="bottom"><b>setOffloadDelayPadding</b> (int32_t delayInFrames, int32_t paddingInFrames)</td></tr> |
205 | 211 | <tr class="separator:aac81c2a3fd1ce1bd19e7b738553d6390"><td class="memSeparator" colspan="2"> </td></tr> |
@@ -1138,6 +1144,144 @@ <h2 class="memtitle"><span class="permalink"><a href="#a43d8a098440cde28f4ee8bed |
1138 | 1144 | </div><div class="memdoc"> |
1139 | 1145 | <dl class="section return"><dt>Returns</dt><dd>true if XRun counts are supported on the stream </dd></dl> |
1140 | 1146 |
|
| 1147 | +</div> |
| 1148 | +</div> |
| 1149 | +<a id="aab76b523480d65f25f7df3c99f2dce47" name="aab76b523480d65f25f7df3c99f2dce47"></a> |
| 1150 | +<h2 class="memtitle"><span class="permalink"><a href="#aab76b523480d65f25f7df3c99f2dce47">◆ </a></span>notifyWorkloadIncrease()</h2> |
| 1151 | + |
| 1152 | +<div class="memitem"> |
| 1153 | +<div class="memproto"> |
| 1154 | +<table class="mlabels"> |
| 1155 | + <tr> |
| 1156 | + <td class="mlabels-left"> |
| 1157 | + <table class="memname"> |
| 1158 | + <tr> |
| 1159 | + <td class="memname">virtual oboe::Result oboe::AudioStream::notifyWorkloadIncrease </td> |
| 1160 | + <td>(</td> |
| 1161 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>cpu</em></span>, </td> |
| 1162 | + </tr> |
| 1163 | + <tr> |
| 1164 | + <td class="paramkey"></td> |
| 1165 | + <td></td> |
| 1166 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>gpu</em></span>, </td> |
| 1167 | + </tr> |
| 1168 | + <tr> |
| 1169 | + <td class="paramkey"></td> |
| 1170 | + <td></td> |
| 1171 | + <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>debugName</em></span> )</td> |
| 1172 | + </tr> |
| 1173 | + </table> |
| 1174 | + </td> |
| 1175 | + <td class="mlabels-right"> |
| 1176 | +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span> </td> |
| 1177 | + </tr> |
| 1178 | +</table> |
| 1179 | +</div><div class="memdoc"> |
| 1180 | +<p>Informs the framework of an upcoming increase in the workload of an audio callback bound to this session. The user can specify whether the increase is expected to be on the CPU, GPU, or both.</p> |
| 1181 | +<p>Sending hints for both CPU and GPU counts as two separate hints for the purposes of the rate limiter.</p> |
| 1182 | +<dl class="params"><dt>Parameters</dt><dd> |
| 1183 | + <table class="params"> |
| 1184 | + <tr><td class="paramname">cpu</td><td>Indicates if the workload increase is expected to affect the CPU. </td></tr> |
| 1185 | + <tr><td class="paramname">gpu</td><td>Indicates if the workload increase is expected to affect the GPU. </td></tr> |
| 1186 | + <tr><td class="paramname">debugName</td><td>A required string used to identify this specific hint during tracing. This debug string will only be held for the duration of the method, and can be safely discarded after.</td></tr> |
| 1187 | + </table> |
| 1188 | + </dd> |
| 1189 | +</dl> |
| 1190 | +<p>This was introduced in Android API Level 36</p> |
| 1191 | +<dl class="section return"><dt>Returns</dt><dd>Result::OK on success. Result::ErrorInvalidState if the PerformanceHint was not enabled. Result::ErrorClosed if AdpfWrapper::open() was not called. Result::ErrorUnimplemented if the API is not supported. Result::ErrorInvalidHandle if no hints were requested. Result::ErrorInvalidRate if the hint was rate limited. Result::ErrorNoService if communication with the system service has failed. Result::ErrorUnavailable if the hint is not supported. </dd></dl> |
| 1192 | + |
| 1193 | +</div> |
| 1194 | +</div> |
| 1195 | +<a id="a3625762def846a6f4b3f48548bfa1b9c" name="a3625762def846a6f4b3f48548bfa1b9c"></a> |
| 1196 | +<h2 class="memtitle"><span class="permalink"><a href="#a3625762def846a6f4b3f48548bfa1b9c">◆ </a></span>notifyWorkloadReset()</h2> |
| 1197 | + |
| 1198 | +<div class="memitem"> |
| 1199 | +<div class="memproto"> |
| 1200 | +<table class="mlabels"> |
| 1201 | + <tr> |
| 1202 | + <td class="mlabels-left"> |
| 1203 | + <table class="memname"> |
| 1204 | + <tr> |
| 1205 | + <td class="memname">virtual oboe::Result oboe::AudioStream::notifyWorkloadReset </td> |
| 1206 | + <td>(</td> |
| 1207 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>cpu</em></span>, </td> |
| 1208 | + </tr> |
| 1209 | + <tr> |
| 1210 | + <td class="paramkey"></td> |
| 1211 | + <td></td> |
| 1212 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>gpu</em></span>, </td> |
| 1213 | + </tr> |
| 1214 | + <tr> |
| 1215 | + <td class="paramkey"></td> |
| 1216 | + <td></td> |
| 1217 | + <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>debugName</em></span> )</td> |
| 1218 | + </tr> |
| 1219 | + </table> |
| 1220 | + </td> |
| 1221 | + <td class="mlabels-right"> |
| 1222 | +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span> </td> |
| 1223 | + </tr> |
| 1224 | +</table> |
| 1225 | +</div><div class="memdoc"> |
| 1226 | +<p>Informs the framework of an upcoming reset in the workload of an audio callback bound to this session, or the imminent start of a new workload. The user can specify whether the reset is expected to affect the CPU, GPU, or both.</p> |
| 1227 | +<p>Sending hints for both CPU and GPU counts as two separate hints for the purposes of the this load tracking.</p> |
| 1228 | +<dl class="params"><dt>Parameters</dt><dd> |
| 1229 | + <table class="params"> |
| 1230 | + <tr><td class="paramname">cpu</td><td>Indicates if the workload reset is expected to affect the CPU. </td></tr> |
| 1231 | + <tr><td class="paramname">gpu</td><td>Indicates if the workload reset is expected to affect the GPU. </td></tr> |
| 1232 | + <tr><td class="paramname">debugName</td><td>A required string used to identify this specific hint during tracing. This debug string will only be held for the duration of the method, and can be safely discarded after.</td></tr> |
| 1233 | + </table> |
| 1234 | + </dd> |
| 1235 | +</dl> |
| 1236 | +<p>This was introduced in Android API Level 36</p> |
| 1237 | +<dl class="section return"><dt>Returns</dt><dd>Result::OK on success. Result::ErrorInvalidState if the PerformanceHint was not enabled. Result::ErrorClosed if AdpfWrapper::open() was not called. Result::ErrorUnimplemented if the API is not supported. Result::ErrorInvalidHandle if no hints were requested. Result::ErrorInvalidRate if the hint was rate limited. Result::ErrorNoService if communication with the system service has failed. Result::ErrorUnavailable if the hint is not supported. </dd></dl> |
| 1238 | + |
| 1239 | +</div> |
| 1240 | +</div> |
| 1241 | +<a id="a5124210a3410ab9e36ea4c4b8b30e7b1" name="a5124210a3410ab9e36ea4c4b8b30e7b1"></a> |
| 1242 | +<h2 class="memtitle"><span class="permalink"><a href="#a5124210a3410ab9e36ea4c4b8b30e7b1">◆ </a></span>notifyWorkloadSpike()</h2> |
| 1243 | + |
| 1244 | +<div class="memitem"> |
| 1245 | +<div class="memproto"> |
| 1246 | +<table class="mlabels"> |
| 1247 | + <tr> |
| 1248 | + <td class="mlabels-left"> |
| 1249 | + <table class="memname"> |
| 1250 | + <tr> |
| 1251 | + <td class="memname">virtual oboe::Result oboe::AudioStream::notifyWorkloadSpike </td> |
| 1252 | + <td>(</td> |
| 1253 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>cpu</em></span>, </td> |
| 1254 | + </tr> |
| 1255 | + <tr> |
| 1256 | + <td class="paramkey"></td> |
| 1257 | + <td></td> |
| 1258 | + <td class="paramtype">bool</td> <td class="paramname"><span class="paramname"><em>gpu</em></span>, </td> |
| 1259 | + </tr> |
| 1260 | + <tr> |
| 1261 | + <td class="paramkey"></td> |
| 1262 | + <td></td> |
| 1263 | + <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>debugName</em></span> )</td> |
| 1264 | + </tr> |
| 1265 | + </table> |
| 1266 | + </td> |
| 1267 | + <td class="mlabels-right"> |
| 1268 | +<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span> </td> |
| 1269 | + </tr> |
| 1270 | +</table> |
| 1271 | +</div><div class="memdoc"> |
| 1272 | +<p>Informs the framework of an upcoming one-off expensive frame for an audio callback bound to this session. This frame will be treated as not representative of the workload as a whole, and it will be discarded the purposes of load tracking. The user can specify whether the workload spike is expected to be on the CPU, GPU, or both.</p> |
| 1273 | +<p>Sending hints for both CPU and GPU counts as two separate hints for the purposes of the rate limiter.</p> |
| 1274 | +<p>This was introduced in Android API Level 36</p> |
| 1275 | +<dl class="params"><dt>Parameters</dt><dd> |
| 1276 | + <table class="params"> |
| 1277 | + <tr><td class="paramname">cpu</td><td>Indicates if the workload spike is expected to affect the CPU. </td></tr> |
| 1278 | + <tr><td class="paramname">gpu</td><td>Indicates if the workload spike is expected to affect the GPU. </td></tr> |
| 1279 | + <tr><td class="paramname">debugName</td><td>A required string used to identify this specific hint during tracing. This debug string will only be held for the duration of the method, and can be safely discarded after.</td></tr> |
| 1280 | + </table> |
| 1281 | + </dd> |
| 1282 | +</dl> |
| 1283 | +<dl class="section return"><dt>Returns</dt><dd>Result::OK on success. Result::ErrorInvalidState if the PerformanceHint was not enabled. Result::ErrorClosed if AdpfWrapper::open() was not called. Result::ErrorUnimplemented if the API is not supported. Result::ErrorInvalidHandle if no hints were requested. Result::ErrorInvalidRate if the hint was rate limited. Result::ErrorNoService if communication with the system service has failed. Result::ErrorUnavailable if the hint is not supported. </dd></dl> |
| 1284 | + |
1141 | 1285 | </div> |
1142 | 1286 | </div> |
1143 | 1287 | <a id="a0ea79e60f5a3d29fc5a1a116aba11dfe" name="a0ea79e60f5a3d29fc5a1a116aba11dfe"></a> |
|
0 commit comments