lightbulb_outline Please take our October 2018 developer survey. Start survey

MediaCodec.CryptoException

public static final class MediaCodec.CryptoException
extends RuntimeException

java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.lang.RuntimeException
         ↳ android.media.MediaCodec.CryptoException


Thrown when a crypto error occurs while queueing a secure input buffer.

Summary

Constants

int ERROR_INSUFFICIENT_OUTPUT_PROTECTION

This indicates that the output protection levels supported by the device are not sufficient to meet the requirements set by the content owner in the license policy.

int ERROR_KEY_EXPIRED

This indicates that the key used for decryption is no longer valid due to license term expiration.

int ERROR_NO_KEY

This indicates that the requested key was not found when trying to perform a decrypt operation.

int ERROR_RESOURCE_BUSY

This indicates that a required crypto resource was not able to be allocated while attempting the requested operation.

int ERROR_SESSION_NOT_OPENED

This indicates that decryption was attempted on a session that is not opened, which could be due to a failure to open the session, closing the session prematurely, or the session being reclaimed by the resource manager.

int ERROR_UNSUPPORTED_OPERATION

This indicates that an operation was attempted that could not be supported by the crypto system of the device in its current configuration.

Public constructors

MediaCodec.CryptoException(int errorCode, String detailMessage)

Public methods

int getErrorCode()

Retrieve the error code associated with a CryptoException

Inherited methods

Constants

ERROR_INSUFFICIENT_OUTPUT_PROTECTION

added in API level 21
public static final int ERROR_INSUFFICIENT_OUTPUT_PROTECTION

This indicates that the output protection levels supported by the device are not sufficient to meet the requirements set by the content owner in the license policy.

Constant Value: 4 (0x00000004)

ERROR_KEY_EXPIRED

added in API level 19
public static final int ERROR_KEY_EXPIRED

This indicates that the key used for decryption is no longer valid due to license term expiration. The operation can be retried after updating the expired keys.

Constant Value: 2 (0x00000002)

ERROR_NO_KEY

added in API level 19
public static final int ERROR_NO_KEY

This indicates that the requested key was not found when trying to perform a decrypt operation. The operation can be retried after adding the correct decryption key.

Constant Value: 1 (0x00000001)

ERROR_RESOURCE_BUSY

added in API level 19
public static final int ERROR_RESOURCE_BUSY

This indicates that a required crypto resource was not able to be allocated while attempting the requested operation. The operation can be retried if the app is able to release resources.

Constant Value: 3 (0x00000003)

ERROR_SESSION_NOT_OPENED

added in API level 23
public static final int ERROR_SESSION_NOT_OPENED

This indicates that decryption was attempted on a session that is not opened, which could be due to a failure to open the session, closing the session prematurely, or the session being reclaimed by the resource manager.

Constant Value: 5 (0x00000005)

ERROR_UNSUPPORTED_OPERATION

added in API level 24
public static final int ERROR_UNSUPPORTED_OPERATION

This indicates that an operation was attempted that could not be supported by the crypto system of the device in its current configuration. It may occur when the license policy requires device security features that aren't supported by the device, or due to an internal error in the crypto system that prevents the specified security policy from being met.

Constant Value: 6 (0x00000006)

Public constructors

MediaCodec.CryptoException

added in API level 16
public MediaCodec.CryptoException (int errorCode, 
                String detailMessage)

Parameters
errorCode int

detailMessage String

This value may be null.

Public methods

getErrorCode

added in API level 16
public int getErrorCode ()

Retrieve the error code associated with a CryptoException

Returns
int