WSB_EcmDecrypter Class

A helper module for extracting the traffic key information from BBTS. More...

Functions
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_Create (const WSB_EcmDecrypter_Listener listener, WSB_Mpeg2TsTrafficKey_Format key_format, const void *key_format_params, WSB_EcmDecrypter **ecm_decrypter)
	Instantiates a new WSB_EcmDecrypter object. More...
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_Destroy (WSB_EcmDecrypter *ecm_decrypter)
	Destroys a WSB_EcmDecrypter object. More...
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_UpdatePmt (WSB_EcmDecrypter *ecm_decrypter, const WSB_Byte *pmt_table, WSB_Size pmt_len, WSB_UInt16 *ecm_pid)
	Provides the ECM decrypter object with a new PMT table. More...
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_UpdateCat (WSB_EcmDecrypter *ecm_decrypter, const WSB_Byte *cat_table, WSB_Size cat_len, WSB_UInt16 *mrt_pid)
	Provides the ECM decrypter object with a new CAT table. More...
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_UpdateEcm (WSB_EcmDecrypter *ecm_decrypter, const WSB_Byte *ecm_table, WSB_Size ecm_len)
	Provides the ECM decrypter object with a new ECM table (KSMT in IEC 62455 terms). More...
WSB_EXPORT WSB_Result	WSB_EcmDecrypter_UpdateMrt (WSB_EcmDecrypter *ecm_decrypter, const WSB_Byte *mr_table, WSB_Size mrt_len)
	Provides the ECM decrypter object with a new MRT (Marlin Rights Table) table. More...

Detailed Description

A helper module for extracting the traffic key information from BBTS.

Function Documentation

WSB_EcmDecrypter_Create()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_Create	(	const WSB_EcmDecrypter_Listener	listener,
		WSB_Mpeg2TsTrafficKey_Format	key_format,
		const void *	key_format_params,
		WSB_EcmDecrypter **	ecm_decrypter
	)

Instantiates a new WSB_EcmDecrypter object.

The object must be destroyed through WSB_EcmDecrypter_Destroy once it is no longer needed.

Parameters

listener	The callback object to be called upon notifications as a result of finding a new media file or a new traffic key.
key_format	The format in which the caller wants the traffic keys.
key_format_params	The parameters of the key format.
ecm_decrypter	Address of a WSB_EcmDecrypter pointer that will be set to refer to the WSB_EcmDecrypter object created.

WSB_EcmDecrypter_Destroy()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_Destroy

(

WSB_EcmDecrypter *

ecm_decrypter

)

Destroys a WSB_EcmDecrypter object.

The client code may not subsequently make references to any WSB_MediaFile or WSB_KeyManager object possibly obtained from interaction with the WSB_EcmDecrypter object being destroyed.

Parameters

ecm_decrypter

The WSB_EcmDecrypter object to be destroyed.

WSB_EcmDecrypter_UpdateCat()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_UpdateCat	(	WSB_EcmDecrypter *	ecm_decrypter,
		const WSB_Byte *	cat_table,
		WSB_Size	cat_len,
		WSB_UInt16 *	mrt_pid
	)

Provides the ECM decrypter object with a new CAT table.

As the CAT table gets processed, the CA descriptor gets extracted and the state of the ECM decrypter gets updated based on that and other information in the CAT.

Parameters

ecm_decrypter	The WSB_EcmDecrypter object.
cat_table	Pointer to the CAT data.
cat_len	Length of the CAT data in bytes.
mrt_pid	The MPEG-2 TS PID of the MRT packets.

WSB_EcmDecrypter_UpdateEcm()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_UpdateEcm	(	WSB_EcmDecrypter *	ecm_decrypter,
		const WSB_Byte *	ecm_table,
		WSB_Size	ecm_len
	)

Provides the ECM decrypter object with a new ECM table (KSMT in IEC 62455 terms).

As the ECM table gets processed, a new content ID or a new traffic key may be detected, and the listener object's methods get invoked accordingly.

Parameters

ecm_decrypter	The WSB_EcmDecrypter object.
ecm_table	Pointer to the ECM table data.
ecm_len	Length of the ECM table data in bytes.

WSB_EcmDecrypter_UpdateMrt()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_UpdateMrt	(	WSB_EcmDecrypter *	ecm_decrypter,
		const WSB_Byte *	mr_table,
		WSB_Size	mrt_len
	)

Provides the ECM decrypter object with a new MRT (Marlin Rights Table) table.

As the MRT table gets processed, a new Silent License Acquisition URL may be detected, and in that case the OnNewMediaFile listener method is invoked.

Parameters

ecm_decrypter	The WSB_EcmDecrypter object.
mr_table	Pointer to the MRT table data.
mrt_len	Length of the MRT table data in bytes.

WSB_EcmDecrypter_UpdatePmt()

WSB_EXPORT WSB_Result WSB_EcmDecrypter_UpdatePmt	(	WSB_EcmDecrypter *	ecm_decrypter,
		const WSB_Byte *	pmt_table,
		WSB_Size	pmt_len,
		WSB_UInt16 *	ecm_pid
	)

Provides the ECM decrypter object with a new PMT table.

As the PMT table gets processed, the CA descriptor gets extracted and the state of the ECM decrypter gets updated based on that and other information in the PMT.

Parameters

ecm_decrypter	The WSB_EcmDecrypter object.
pmt_table	Pointer to the PMT data.
pmt_len	Length of the PMT data in bytes.
ecm_pid	The MPEG-2 TS PID of the ECM packets.