WsbMediaAesDecrypter.h

Go to the documentation of this file.

/*****************************************************************
|
|   Wasabi - Media AES Decrypter API
|
|   $Id: WsbMediaAesDecrypter.h 14593 2018-07-24 02:02:16Z hwa $
|   Original author: John Hwa
|
|   This software is provided to you pursuant to your agreement
|   with Intertrust Technologies Corporation ("Intertrust").
|   This software may be used only in accordance with the terms
|   of the agreement.
|
|   Copyright (c) 2018 by Intertrust. All rights reserved.
|
****************************************************************/
#ifndef _WSB_MEDIA_AES_DECRYPTER_H_
#define _WSB_MEDIA_AES_DECRYPTER_H_

/*----------------------------------------------------------------------
|   includes
+---------------------------------------------------------------------*/
#include "WsbTypes.h"
#include "Ts2Iec62455.h"

/*----------------------------------------------------------------------
|   macros
+---------------------------------------------------------------------*/
#define WSB_MAD_VERSION 0X00010000

#define WSB_MADS_COMMON_ENC_CENC 1
#define WSB_MADS_COMMON_ENC_CBCS 2
#define WSB_MADS_BBTS_CBC        3 /* only support BBTS >= 2.0.0 */

/*----------------------------------------------------------------------
|   types
+---------------------------------------------------------------------*/
typedef struct {
    WSB_Size content_id_size;

    const WSB_Byte* content_id;

    WSB_Size content_key_size;

    const WSB_Byte* content_key;
} WSB_DecContentAccess;

typedef struct {
    WSB_DecContentAccess content_access;
} WSB_DecSchemeCencCenc;

typedef struct {
    WSB_DecContentAccess content_access;

    WSB_Size crypt_byte_block;
    WSB_Size skip_byte_block;

    WSB_Size constant_iv_size;

    const WSB_Byte* constant_iv;
} WSB_DecSchemeCencCbcs;

typedef struct {
    WSB_UInt32 version;

    WSB_Byte decryption_scheme;
    union {
        WSB_DecSchemeCencCenc cenc;
        WSB_DecSchemeCencCbcs cbcs;
    } scheme;
} WSB_MediaAesDecrypterConfig;

typedef struct {
    WSB_Size clear_data_size;

    WSB_Size proteced_data_size;
} WSB_CommonEncSubsample;

typedef struct {
    WSB_Size per_sample_iv_size;

    const WSB_Byte* per_sample_iv;

    WSB_UInt32              subsample_count;
    WSB_CommonEncSubsample* subsamples;
} WSB_CommonEncCencSampleParams;

typedef struct {
    WSB_UInt32              subsample_count;
    WSB_CommonEncSubsample* subsamples;
} WSB_CommonEncCbcsSampleParams;

typedef struct {
    WSB_UInt32 ts_packet_count;
} WSB_BbtsPacketParams;

typedef struct {
    WSB_Byte decryption_scheme;
    union {
        WSB_CommonEncCencSampleParams cenc;
        WSB_CommonEncCbcsSampleParams cbcs;
        WSB_BbtsPacketParams          bbts;
    } of; 
} WSB_MediaAesDecrypterParams;

typedef struct {
    WSB_UInt32 kdf_type;

    WSB_Size        ksmt_section_size;
    const WSB_Byte* ksmt_section;
} WSB_BbtsUpdate;

typedef struct {
    WSB_DecContentAccess content_access;

    WSB_Byte decryption_scheme;
    union {
        WSB_BbtsUpdate bbts;
    } of;
} WSB_MediaAesDecrypterUpdate;

/*----------------------------------------------------------------------
|   functions
+---------------------------------------------------------------------*/
#if defined(__cplusplus)
extern "C" {
#endif

typedef struct WSB_MediaAesDecrypter WSB_MediaAesDecrypter;

WSB_EXPORT WSB_Result
WSB_MediaAesDecrypter_Create(const WSB_MediaAesDecrypterConfig* config,
                             WSB_MediaAesDecrypter**            decrypter);

WSB_EXPORT WSB_Result
WSB_MediaAesDecrypter_Decrypt(WSB_MediaAesDecrypter*             decrypter,
                              const WSB_MediaAesDecrypterParams* in_params,
                              const WSB_Byte*                    in_data,
                              WSB_UInt32                         in_data_size,
                              WSB_Byte**                         sec_buf,
                              WSB_UInt32*                        sec_buf_size);

WSB_EXPORT WSB_Result
WSB_MediaAesDecrypter_Update(WSB_MediaAesDecrypter*             decrypter,
                             const WSB_MediaAesDecrypterUpdate* update);

WSB_EXPORT WSB_Result
WSB_MediaAesDecrypter_Destroy(WSB_MediaAesDecrypter* decrypter);

#if defined(__cplusplus)
}
#endif

#endif /* _WSB_MEDIA_AES_DECRYPTER_H_ */