WsbMediaStream.h

Go to the documentation of this file.

/*****************************************************************
|
|   Wasabi - Media Stream API
|
|   $Id: WsbMediaStream.h 12416 2016-04-26 16:39:31Z hwa $
|   Original author: Edin Hodzic ([email protected])
|
|   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) 2013-2014 by Intertrust. All rights reserved. 
|
****************************************************************/
#ifndef _WSB_MEDIA_STREAM_H_
#define _WSB_MEDIA_STREAM_H_

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

/*----------------------------------------------------------------------
|   macros
+---------------------------------------------------------------------*/
#define WSB_MEDIASTREAM_CONTENT_TYPE_DCF       "application/vnd.oma.drm.dcf"
#define WSB_MEDIASTREAM_CONTENT_TYPE_AES128CBC "application/vnd.intertrust.drm.aes128.cbc"
#define WSB_MEDIASTREAM_CONTENT_TYPE_AES128CTR "application/vnd.intertrust.drm.aes128.ctr"

/*----------------------------------------------------------------------
|   WSB_MediaStream_Interface
+---------------------------------------------------------------------*/
typedef struct WSB_MediaStream WSB_MediaStream;
typedef struct WSB_KeyManager WSB_MediaStreamKey;
typedef struct {
    WSB_Result (*Read)(WSB_MediaStream* self, void* buffer, WSB_Size* read_bytes);
    WSB_Result (*Seek)(WSB_MediaStream* self, WSB_Position position);
    WSB_Result (*Tell)(WSB_MediaStream* self, WSB_Position* position);
    WSB_Result (*GetSize)(WSB_MediaStream* self, WSB_LargeSize* size);
    WSB_Result (*GetContentType)(WSB_MediaStream* self, const char** content_type);
    WSB_Result (*GetKey)(WSB_MediaStream* self, const WSB_MediaStreamKey** key);
    WSB_Result (*Close)(WSB_MediaStream* self);
} WSB_MediaStreamInterface;

/*----------------------------------------------------------------------
|   WSB_MediaStream
+---------------------------------------------------------------------*/
struct WSB_MediaStream {
    WSB_MediaStreamInterface* iface;
};

/*----------------------------------------------------------------------
|   WSB_MediaStream_SourceType
+---------------------------------------------------------------------*/
typedef enum {
    WSB_MEDIASTREAM_SOURCE_TYPE_DCF,

    WSB_MEDIASTREAM_SOURCE_TYPE_AES128CBC,

    WSB_MEDIASTREAM_SOURCE_TYPE_AES128CTR
} WSB_MediaStream_SourceType;

/*----------------------------------------------------------------------
|   WSB_MediaStream_FormatInfo
+---------------------------------------------------------------------*/
typedef union {
    struct WSB_MediaStream_FormatInfo_Common {
        const char*     content_id;

        const char*     ms3_url;

        const WSB_MediaStreamKey* key;

        const char*     license_data;

        WSB_Size        license_data_size;

        const WSB_Byte* iv;

        WSB_Size counter_size;

        WSB_LargeSize clear_text_size;

    } common;
} WSB_MediaStream_FormatInfo;


#ifdef __cplusplus
extern "C" {
#elif 0
}
#endif

/*----------------------------------------------------------------------
|   functions
+---------------------------------------------------------------------*/
WSB_EXPORT WSB_Result
WSB_MediaStream_OpenUrl(const char*                       source_url,
                        WSB_MediaStream_SourceType        source_type,
                        const WSB_MediaStream_FormatInfo* format_info,
                        WSB_MediaStream**                 stream);

WSB_EXPORT WSB_Result
WSB_MediaStream_Open(WSB_MediaStream*                  source_stream,
                     const WSB_MediaStream_FormatInfo* format_info,
                     WSB_MediaStream**                 stream);

WSB_EXPORT WSB_Result
WSB_MediaStream_Read(WSB_MediaStream* self, void* buffer, WSB_Size* read_bytes);

WSB_EXPORT WSB_Result
WSB_MediaStream_Seek(WSB_MediaStream* self, WSB_Position position);

WSB_EXPORT WSB_Result
WSB_MediaStream_Tell(WSB_MediaStream* self, WSB_Position* position);

WSB_EXPORT WSB_Result
WSB_MediaStream_GetSize(WSB_MediaStream* self, WSB_LargeSize* size);

WSB_EXPORT WSB_Result
WSB_MediaStream_GetContentType(WSB_MediaStream* self, const char** content_type);

WSB_EXPORT WSB_Result
WSB_MediaStream_GetKey(WSB_MediaStream* self, const WSB_MediaStreamKey** key);

WSB_EXPORT WSB_Result 
WSB_MediaStream_Close(WSB_MediaStream* self);

#ifdef __cplusplus
}
#endif

#endif // _WSB_MEDIA_STREAM_H_