/*
* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: implementation
*
*/
#ifndef MSRTPCRYPTOHANDLERCONTEXT_H
#define MSRTPCRYPTOHANDLERCONTEXT_H
#include <e32std.h>
// CLASS DECLARATION
/*
* A context for stream classes for using common crypto handling operations.
* These are common for both RTP and RTCP
*
* @lib n/a
*/
class MSRTPCryptoHandlerContext
{
public:
/*
* virtual function for initializing
* plain packet class (CSRTPPacketRTP or CSRTPPacketRTCP)
* @param aPacket RTP/RTCP packet.
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void InitializePlainPacketL(const TDesC8& aPacket) = 0;
/*
* virtual function for initializing
* encrypted packet class (CSRTPPacketSRTP or CSRTPPacketSRTCP)
* @param aPacket SRTP/SRTCP packet.
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void InitializeEncryptedPacketL(const TDesC8& aPacket) = 0;
/*
* virtual function for deriving session keys
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void DeriveSessionKeysL() = 0;
/*
* virtual function for checking that crypto context MKI and
* packet MKI match.
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void CheckMasterKeyIdentifierL() = 0;
/*
* virtual function for performing the authentication step
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void AuthenticateL() = 0;
/*
* virtual function for performing the replay protection step
* @leave KErrNone if success, system-wide error code otherwise
* @return void
*/
virtual void ReplayProtectionL() = 0;
/*
* virtual function for encrypting plain packet
* @leave KErrNone if success, system-wide error code otherwise
* @return encrypted packet
*/
virtual HBufC8* EncryptL() = 0;
/*
* virtual function for decrypting ciphered packet
* @leave KErrNone if success, system-wide error code otherwise
* @return plain packet
*/
virtual HBufC8* DecryptL() = 0;
/*
* virtual function for querying whether master key or salt has been updated
* @return master keys update status
*/
virtual TBool MasterKeysUpdated() = 0;
/*
* virtual function for incrementing Replay Protection Index after
* the packet has been authenticated
* @return void
*/
virtual void AddReplayIndex() =0;
};
#endif //MSRTPCryptoHandlerContext_H