Wasabi ExpressPlay SDK for Embedded Systems  1.23.0
Data Fields
WSB_EcmDecrypter_Listener Struct Reference

ECM decrypter listener callback object type. More...

#include <WsbEcmDecrypter.h>

Data Fields

void * instance
 Listener instance pointer; gets passed into callback methods. More...
 
WSB_Result(* OnNewMediaFile )(void *instance, WSB_MediaFile *media_file, WSB_KeyManager *key_manager)
 Callback method invoked on a new or updated media file detection. More...
 
void(* OnKsmInfoChange )(void *instance, const WSB_KsmInfo *key_info, WSB_UInt32 change_mask)
 Callback method invoked on a new MPEG-2 TS traffic key recovery. More...
 

Detailed Description

ECM decrypter listener callback object type.

Field Documentation

◆ instance

void* WSB_EcmDecrypter_Listener::instance

Listener instance pointer; gets passed into callback methods.

◆ OnKsmInfoChange

void(* WSB_EcmDecrypter_Listener::OnKsmInfoChange) (void *instance, const WSB_KsmInfo *key_info, WSB_UInt32 change_mask)

Callback method invoked on a new MPEG-2 TS traffic key recovery.

The newly recovered traffic key can be used for media decryption. Different key formats are supported. The key hasn't been loaded into any software or hardware media decrypter at this point, and the listener may need to load the key into a software object or a hardware module for MPEG-2 TS decryption.

Parameters
instanceThe client context originally passed in to WSB_EcmDecrypter_Create as part of the listener object.
key_infoPointer to a WSB_KsmInfo structure containing the newly decrypted traffic key object.
change_maskA set of WSB_KsmInfoFlag values, bitwise OR'ed together, indicating which fields of the structure have changed since the previous call to OnKsmInfoChange.

◆ OnNewMediaFile

WSB_Result(* WSB_EcmDecrypter_Listener::OnNewMediaFile) (void *instance, WSB_MediaFile *media_file, WSB_KeyManager *key_manager)

Callback method invoked on a new or updated media file detection.

The implementation must "enable" the new media file through the WSB_PlaybackEnabler API, and ensure the provided key_manager object gets filled in with DRM keys (using WSB_PlaybackEnabler_AcceptActionResult).

The WSB_MediaFile gets updated or recreated, as appropriate, when there is a new content ID or a new Silent License Acquisition URL.

Parameters
instanceThe client context originally passed in to WSB_EcmDecrypter_Create as part of the listener object.
media_fileWSB_MediaFile object provided and owned by the corresponding WSB_EcmDecrypter instance. The media_file object can only be used in this OnNewMediaFile callback method.
key_managerDRM key manager object provided and owned by the corresponding WSB_EcmDecrypter instance. The key_manager object can only be used in this OnNewMediaFile callback method.
Returns
WSB_SUCCESS if the key manager was populated successfully. Otherwise, an error code.

The documentation for this struct was generated from the following file: