8378c6625e
New codes are being added to handle resource contention, lost session state, frame size too large and insufficient security level for decryption. Also cleans up inconsistent use of tamper detected error where invalid state error should have been used. bug:111504510 bug:111505796 test: cts and gts media test cases Change-Id: I8581aed1871d728f7af80b246d0dba28b40fa4a3
84 lines
3.9 KiB
Text
84 lines
3.9 KiB
Text
/**
|
|
* Copyright (C) 2018 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
package android.hardware.drm@1.2;
|
|
|
|
import @1.0::DestinationBuffer;
|
|
import @1.0::ICryptoPlugin;
|
|
import @1.0::Mode;
|
|
import @1.0::Pattern;
|
|
import @1.0::SessionId;
|
|
import @1.0::SharedBuffer;
|
|
import @1.0::SubSample;
|
|
|
|
/**
|
|
* ICryptoPlugin is the HAL for vendor-provided crypto plugins.
|
|
* It allows crypto sessions to be opened and operated on, to
|
|
* load crypto keys for a codec to decrypt protected video content.
|
|
*/
|
|
interface ICryptoPlugin extends @1.0::ICryptoPlugin {
|
|
|
|
/**
|
|
* Decrypt an array of subsamples from the source memory buffer to the
|
|
* destination memory buffer.
|
|
*
|
|
* decrypt_1_2() only differs from decrypt() in that additional status
|
|
* codes must be returned.
|
|
*
|
|
* @param secure a flag to indicate if a secure decoder is being used. This
|
|
* enables the plugin to configure buffer modes to work consistently with
|
|
* a secure decoder.
|
|
* @param the keyId for the key that is used to do the the decryption. The
|
|
* keyId refers to a key in the associated MediaDrm instance.
|
|
* @param iv the initialization vector to use
|
|
* @param mode the crypto mode to use
|
|
* @param pattern the crypto pattern to use
|
|
* @param subSamples a vector of subsamples indicating the number
|
|
* of clear and encrypted bytes to process. This allows the decrypt
|
|
* call to operate on a range of subsamples in a single call
|
|
* @param source the input buffer for the decryption
|
|
* @param offset the offset of the first byte of encrypted data from
|
|
* the base of the source buffer
|
|
* @param destination the output buffer for the decryption
|
|
* @return status the status of the call. The status must be OK or one
|
|
* of the following errors:
|
|
* ERROR_DRM_NO_LICENSE if no license keys have been loaded
|
|
* ERROR_DRM_LICENSE_EXPIRED if the license keys have expired
|
|
* ERROR_DRM_RESOURCE_BUSY if the resources required to perform
|
|
* the decryption are not available
|
|
* ERROR_DRM_INSUFFICIENT_OUTPUT_PROTECTION if required output
|
|
* protections are not active
|
|
* ERROR_DRM_INSUFFICIENT_SECURITY if the security level of the
|
|
* device is not sufficient to meet the requirements in
|
|
* the license policy
|
|
* ERROR_DRM_FRAME_TOO_LARGE if the frame being decrypted into
|
|
* the secure output buffer exceeds the size of the buffer
|
|
* ERROR_DRM_SESSION_NOT_OPENED if the decrypt session is not
|
|
* opened
|
|
* ERROR_DRM_DECRYPT if the decrypt operation fails
|
|
* ERROR_DRM_INVALID_STATE if the device is in a state where it
|
|
* is not able to perform decryption
|
|
* ERROR_DRM_CANNOT_HANDLE in other failure cases.
|
|
*
|
|
* @return bytesWritten the number of bytes output from the decryption
|
|
* @return detailedError if the error is a vendor-specific error, the
|
|
* vendor's crypto HAL may provide a detailed error string to help
|
|
* describe the error.
|
|
*/
|
|
decrypt_1_2(bool secure, uint8_t[16] keyId, uint8_t[16] iv, Mode mode,
|
|
Pattern pattern, vec<SubSample> subSamples,
|
|
SharedBuffer source, uint64_t offset, DestinationBuffer destination)
|
|
generates(Status status, uint32_t bytesWritten, string detailedError);
|
|
};
|