Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add java doc to explain the return for insufficient resource." into rvc-dev

Browse Source
This commit is contained in:
Henry Fang
2020-03-17 22:23:28 +00:00
committed by Android (Google) Code Review
parent 379322f066 61abe8ab63
commit 9fa94145b8
2 changed files with 18 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
media/java/android/media/MediaCas.java
View File

@@ -870,16 +870,17 @@ public final class MediaCas implements AutoCloseable {
private int getSessionResourceId() throws MediaCasException {
validateInternalStates();
int[] sessionResourceId = new int[1];
sessionResourceId[0] = -1;
int[] sessionResourceHandle = new int[1];
sessionResourceHandle[0] = -1;
if (mTunerResourceManager != null) {
CasSessionRequest casSessionRequest = new CasSessionRequest(mClientId, mCasSystemId);
if (!mTunerResourceManager.requestCasSession(casSessionRequest, sessionResourceId)) {
throw new MediaCasException.ResourceBusyException(
if (!mTunerResourceManager
.requestCasSession(casSessionRequest, sessionResourceHandle)) {
throw new MediaCasException.InsufficientResourceException(
"insufficient resource to Open Session");
}
}
return sessionResourceId[0];
return sessionResourceHandle[0];
}
private void addSessionToResourceMap(Session session, int sessionResourceId) {
@@ -905,6 +906,10 @@ public final class MediaCas implements AutoCloseable {
* Open a session to descramble one or more streams scrambled by the
* conditional access system.
*
* <p>Tuner resource manager (TRM) uses the client priority value to decide whether it is able
* to get cas session resource if cas session resources is limited. If the client can't get the
* resource, this call returns {@link MediaCasException.InsufficientResourceException }.
*
* @return session the newly opened session.
*
* @throws IllegalStateException if the MediaCas instance is not valid.
@@ -930,6 +935,10 @@ public final class MediaCas implements AutoCloseable {
* Open a session with usage and scrambling information, so that descrambler can be configured
* to descramble one or more streams scrambled by the conditional access system.
*
* <p>Tuner resource manager (TRM) uses the client priority value to decide whether it is able
* to get cas session resource if cas session resources is limited. If the client can't get the
* resource, this call returns {@link MediaCasException.InsufficientResourceException}.
*
* @param sessionUsage used for the created session.
* @param scramblingMode used for the created session.
*

4
media/java/android/media/tv/tuner/Tuner.java
View File

@@ -453,6 +453,10 @@ public class Tuner implements AutoCloseable {
/**
* Tunes the frontend to using the settings given.
*
* <p>Tuner resource manager (TRM) uses the client priority value to decide whether it is able
* to get frontend resource. If the client can't get the resource, this call returns {@link
* Result#RESULT_UNAVAILABLE}.
*
* <p>
* This locks the frontend to a frequency by providing signal
* delivery information. If previous tuning isn't completed, this stop the previous tuning, and