HdiDrm

概述

DRM模块接口定义。 DRM是数字版权管理，用于对多媒体内容加密，以便保护价值内容不被非法获取，DRM模块接口定义了DRM实例管理、DRM会话管理、DRM内容解密的接口。

起始版本： 4.1

汇总

文件

名称 描述
IMediaDecryptModule.idl 定义了DRM内容解密接口、解密模块实例释放接口。
IMediaKeySession.idl 定义了DRM会话功能接口。
IMediaKeySessionCallback.idl 定义了DRM会话的事件通知接口。
IMediaKeySystem.idl 定义了DRM实例的功能接口。
IMediaKeySystemCallback.idl 定义了DRM实例的事件通知接口。
IMediaKeySystemFactory.idl 定义了DRM实例的工厂方法。
IOemCertificate.idl 定义了不同厂商证书下载的接口。
MediaKeySystemTypes.idl 定义了HdiDrm使用的类型及结构。

类

名称 描述
interface  IMediaDecryptModule 定义内容解密、解密模块实例释放函数。用于解密加密的内容。
interface  IMediaKeySession DRM会话功能接口，获取/设置许可证、查询当前会话许可证状态、删除当前会话许可证、释放许可证、恢复离线许可证、 判断是否需要安全内存中解密、获取解密模块实例、设置会话消息通知接口、销毁会话。
interface  IMediaKeySessionCallback 定义DRM会话的事件通知函数，用于DRM驱动通知DRM框架事件。
interface  IMediaKeySystem DRM实例功能接口，判断是否支持特定DRM方案，创建DRM实例。
interface  IMediaKeySystemCallback 定义DRM实例的事件通知函数。
interface  IMediaKeySystemFactory DRM实例工厂方法接口，判断是否支持特定DRM方案，创建DRM实例。
interface  IOemCertificate 厂商证书下载接口。 产生证书下载请求，处理下载的证书。
struct  MediaKeyRequestInfo 定义MediaKeyRequestInfo，该信息由IMediaKeySession::GenerateMediaKeyRequest使用。
struct  MediaKeyRequest 定义MediaKeyRequest，该信息由IMediaKeySession::GenerateMediaKeyRequest使用。
struct  Pattern 定义Pattern，该信息由CryptoInfo使用。
struct  SubSample 定义SubSample，该信息由CryptoInfo使用。
struct  CryptoInfo 定义CryptoInfo，该信息由IMediaDecryptModule::DecryptMediaData使用。
struct  DrmBuffer 定义DrmBuffer，该信息由IMediaDecryptModule::DecryptMediaData使用。

枚举

名称 描述
ContentProtectionLevel {
SECURE_UNKNOWN = 0 , SW_SECURE_CRYPTO , HW_SECURE_CRYPTO , HW_ENHANCED_SECURE_CRYPTO , HW_SECURE_MAX
}		 内容保护等级。
MediaKeyRequestType {
MEDIA_KEY_REQUEST_TYPE_UNKNOWN = 0 , MEDIA_KEY_REQUEST_TYPE_INITIAL , MEDIA_KEY_REQUEST_TYPE_RENEWAL , MEDIA_KEY_REQUEST_TYPE_RELEASE , MEDIA_KEY_REQUEST_TYPE_NONE , MEDIA_KEY_REQUEST_TYPE_UPDATE
}		 许可证请求类型。
EventType {
EVENTTYPE_PROVISIONREQUIRED = 0 , EVENTTYPE_KEYREQUIRED , EVENTTYPE_KEYEXPIRED , EVENTTYPE_VENDOR_DEFINED , EVENTTYPE_EXPIRATIONUPDATE , EVENTTYPE_KEYCHANGE
}		 DRM插件监听事件类型。
CryptoAlgorithmType {
ALGTYPE_UNENCRYPTED = 0 , ALGTYPE_AES_CTR , ALGTYPE_AES_WV , ALGTYPE_AES_CBC , ALGTYPE_SM4_CBC , ALGTYPE_SM4_CTR
}		 加密算法类型。
OfflineMediaKeyStatus { OFFLINE_MEDIA_KEY_STATUS_UNKNOWN = 0 , OFFLINE_MEDIA_KEY_STATUS_USABLE , OFFLINE_MEDIA_KEY_STATUS_INACTIVE } 离线许可证状态。
MediaKeyType { MEDIA_KEY_TYPE_OFFLINE = 0 , MEDIA_KEY_TYPE_ONLINE } 许可证类型。
CertificateStatus {
CERT_STATUS_PROVISIONED = 0 , CERT_STATUS_NOT_PROVISIONED , CERT_STATUS_EXPIRED , CERT_STATUS_INVALID , CERT_STATUS_UNAVAILABLE
}		 证书状态。
MediaKeySessionKeyStatus {
MEDIA_KEY_SESSION_KEY_STATUS_USABLE = 0 , MEDIA_KEY_SESSION_KEY_STATUS_EXPIRED , MEDIA_KEY_SESSION_KEY_STATUS_OUTPUT_NOT_ALLOWED , MEDIA_KEY_SESSION_KEY_STATUS_PENDING , MEDIA_KEY_SESSION_KEY_STATUS_INTERNAL_ERROR , MEDIA_KEY_SESSION_KEY_STATUS_USABLE_IN_FUTURE
}		 会话许可证状态。

枚举类型说明

CertificateStatus

enum CertificateStatus

描述

证书状态。

起始版本： 4.1

枚举值 描述
CERT_STATUS_PROVISIONED 证书已设置。
CERT_STATUS_NOT_PROVISIONED 证书未设置。
CERT_STATUS_EXPIRED 证书过期。
CERT_STATUS_INVALID 证书无效。
CERT_STATUS_UNAVAILABLE 获取证书状态失败。

ContentProtectionLevel

enum ContentProtectionLevel

描述

内容保护等级。

起始版本： 4.1

枚举值 描述
SECURE_UNKNOWN 未知等级。
SW_SECURE_CRYPTO 软件安全等级。
HW_SECURE_CRYPTO 硬件安全等级。
HW_ENHANCED_SECURE_CRYPTO 增强硬件安全等级。
HW_SECURE_MAX 安全等级最大值，用于判断非法安全等级。

CryptoAlgorithmType

enum CryptoAlgorithmType

描述

加密算法类型。

起始版本： 4.1

枚举值 描述
ALGTYPE_UNENCRYPTED 未加密。
ALGTYPE_AES_CTR aes_ctr加密。
ALGTYPE_AES_WV aes_wv加密。
ALGTYPE_AES_CBC aes_cbc加密。
ALGTYPE_SM4_CBC sm4_cbc加密。
ALGTYPE_SM4_CTR sm4_ctr加密。

EventType

enum EventType

描述

DRM插件监听事件类型。

起始版本： 4.1

枚举值 描述
EVENTTYPE_PROVISIONREQUIRED 证书下载。
EVENTTYPE_KEYREQUIRED 许可证获取。
EVENTTYPE_KEYEXPIRED 许可证过期。
EVENTTYPE_VENDOR_DEFINED 厂商自定义事件。
EVENTTYPE_EXPIRATIONUPDATE 许可证有效期更新。
EVENTTYPE_KEYCHANGE 许可证变更。

MediaKeyRequestType

enum MediaKeyRequestType

描述

许可证请求类型。

起始版本： 4.1

枚举值 描述
MEDIA_KEY_REQUEST_TYPE_UNKNOWN 未知类型。
MEDIA_KEY_REQUEST_TYPE_INITIAL 初次请求。
MEDIA_KEY_REQUEST_TYPE_RENEWAL 再次许可证请求。
MEDIA_KEY_REQUEST_TYPE_RELEASE 释放许可证请求。
MEDIA_KEY_REQUEST_TYPE_NONE 无类型。
MEDIA_KEY_REQUEST_TYPE_UPDATE 许可证更新请求。

MediaKeySessionKeyStatus

enum MediaKeySessionKeyStatus

描述

会话许可证状态。

起始版本： 4.1

枚举值 描述
MEDIA_KEY_SESSION_KEY_STATUS_USABLE 许可证可用。
MEDIA_KEY_SESSION_KEY_STATUS_EXPIRED 许可证过期。
MEDIA_KEY_SESSION_KEY_STATUS_OUTPUT_NOT_ALLOWED 该许可证不允许输出。
MEDIA_KEY_SESSION_KEY_STATUS_PENDING 暂时不可用许可证。
MEDIA_KEY_SESSION_KEY_STATUS_INTERNAL_ERROR 许可证内部状态错误。
MEDIA_KEY_SESSION_KEY_STATUS_USABLE_IN_FUTURE 许可证待生效。

MediaKeyType

enum MediaKeyType

描述

许可证类型。

起始版本： 4.1

枚举值 描述
MEDIA_KEY_TYPE_OFFLINE 离线许可证。
MEDIA_KEY_TYPE_ONLINE 在线许可证。

OfflineMediaKeyStatus

enum OfflineMediaKeyStatus

描述

离线许可证状态。

起始版本： 4.1

枚举值 描述
OFFLINE_MEDIA_KEY_STATUS_UNKNOWN 未知状态。
OFFLINE_MEDIA_KEY_STATUS_USABLE 许可证可用。
OFFLINE_MEDIA_KEY_STATUS_INACTIVE 许可证不可用（未在生效时间段内、已过期等）。