hxstats.h

linux下的一款播放器

/* ***** BEGIN LICENSE BLOCK *****
 * Source last modified: $Id: hxstats.h,v 1.11.2.3 2004/07/09 01:45:13 hubbe Exp $
 * 
 * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
 * 
 * The contents of this file, and the files included with this file,
 * are subject to the current version of the RealNetworks Public
 * Source License (the "RPSL") available at
 * http://www.helixcommunity.org/content/rpsl unless you have licensed
 * the file under the current version of the RealNetworks Community
 * Source License (the "RCSL") available at
 * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
 * will apply. You may also obtain the license terms directly from
 * RealNetworks.  You may not use this file except in compliance with
 * the RPSL or, if you have a valid RCSL with RealNetworks applicable
 * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
 * the rights, obligations and limitations governing use of the
 * contents of the file.
 * 
 * Alternatively, the contents of this file may be used under the
 * terms of the GNU General Public License Version 2 or later (the
 * "GPL") in which case the provisions of the GPL are applicable
 * instead of those above. If you wish to allow use of your version of
 * this file only under the terms of the GPL, and not to allow others
 * to use your version of this file under the terms of either the RPSL
 * or RCSL, indicate your decision by deleting the provisions above
 * and replace them with the notice and other provisions required by
 * the GPL. If you do not delete the provisions above, a recipient may
 * use your version of this file under the terms of any one of the
 * RPSL, the RCSL or the GPL.
 * 
 * This file is part of the Helix DNA Technology. RealNetworks is the
 * developer of the Original Code and owns the copyrights in the
 * portions it created.
 * 
 * This file, and the files included with this file, is distributed
 * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
 * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
 * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
 * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
 * ENJOYMENT OR NON-INFRINGEMENT.
 * 
 * Technology Compatibility Kit Test Suite(s) Location:
 *    http://www.helixcommunity.org/content/tck
 * 
 * Contributor(s):
 * 
 * ***** END LICENSE BLOCK ***** */

///////////////////////////////////////////////////////////////////////////////
// hxstats.h - Client stats interfaces. 
///////////////////////////////////////////////////////////////////////////////

#ifndef HXSTATS_H
#define HXSTATS_H

///////////////////////////////////////////////////////////////////////////////
// INCLUDES
///////////////////////////////////////////////////////////////////////////////

#include <limits.h>


///////////////////////////////////////////////////////////////////////////////
// ClientStatsEvent
///////////////////////////////////////////////////////////////////////////////

typedef enum 
{
    CSEVENT_UNKNOWN,
    CSEVENT_CLIENT_CONNECT,
    CSEVENT_CLIENT_DISCONNECT,
    CSEVENT_SESSION_DONE,
    CSEVENT_TIMER,
    CSEVENT_SESSION_SETURL
} ClientStatsEvent;

///////////////////////////////////////////////////////////////////////////////

_INTERFACE      IUnknown;

_INTERFACE      IHXBuffer;
_INTERFACE      IHXQoSTransportAdaptationInfo;
_INTERFACE      IHXQoSSessionAdaptationInfo;
_INTERFACE      IHXQoSApplicationAdaptationInfo;
_INTERFACE      IHXClientProfileInfo;

_INTERFACE      IHXClientStats;
_INTERFACE      IHXSessionStats;
_INTERFACE      IHXClientStatsSink;
_INTERFACE      IHXClientStatsManager;


///////////////////////////////////////////////////////////////////////////////
// Interface: 
//
//      IHXSessionStats
//
// Purpose:
//
//      Allows access to session statistics. 
//
// IID_IHXSessionStats:
//
//      {3C02C47F-6F44-47fd-B625-C81A2BF05D4F}
//
///////////////////////////////////////////////////////////////////////////////

// {3C02C47F-6F44-47fd-B625-C81A2BF05D4F}
DEFINE_GUID(IID_IHXSessionStats, 0x3c02c47f, 0x6f44, 0x47fd, 0xb6, 
            0x25, 0xc8, 0x1a, 0x2b, 0xf0, 0x5d, 0x4f);

#define CLSID_IHXSessionStats     IID_IHXSessionStats

#undef  INTERFACE
#define INTERFACE   IHXSessionStats

///////////////////////////////////////////////////////////////////////////////
// End Status Values
///////////////////////////////////////////////////////////////////////////////

/*
 * First bit indicates success/error.
 * Next two bits indicate error source: server, client, + room for expansion
 *
 * 000  No error
 * 100  Client/remote-socket error
 * 101  Server error
 * 110  Undetermined
 * 111  Reserved
 */

#define SSES_ERROR_MASK               0xE0000000
#define SSES_CLIENT_ERROR_VALUE       0x80000000
#define SSES_SERVER_ERROR_VALUE       0xA0000000
#define SSES_UNDETERMINED_ERROR_VALUE 0xC0000000

#define SSES_SUCCESS(x) (!((x) & 0x80000000))
#define SSES_FAILURE(x)   ((x) & 0x80000000)

#define SSES_FAILURE_CLIENT(x)  (((x) & SSES_ERROR_MASK) == SSES_CLIENT_ERROR_VALUE)
#define SSES_FAILURE_SERVER(x)  (((x) & SSES_ERROR_MASK) == SSES_SERVER_ERROR_VALUE)
#define SSES_FAILURE_UNDETERMINED(x)  \
                          (((x) & SSES_ERROR_MASK) == SSES_UNDETERMINED_ERROR_VALUE)

typedef enum
{
    // success codes
    SSES_OK=0,

    // client errors
    SSES_SOCKET_CLOSED        =0x80000000,
    SSES_CLIENT_TIMEOUT       =0x80000001,
    SSES_INVALID_FILE         =0x80000002,

    // server errors
    SSES_SERVER_INTERNAL_ERROR=0xA0000000,
    SSES_SERVER_ALERT         =0xA0000001,
    SSES_SOCKET_BLOCKED       =0xA0000002,
    SSES_REDIRECTED           =0xA0000003,

    // indeterminate errors
    SSES_UNKNOWN_ERROR=0xC0000000,

    SSES_NOT_ENDED=0xffffffff	// session still active, no end status yet
} SessionStatsEndStatus;

DECLARE_INTERFACE_(IHXSessionStats, IUnknown)
{

    // IUnknown methods

    STDMETHOD(QueryInterface)               (THIS_
                                            REFIID riid,
                                            void** ppvObj) PURE;

    STDMETHOD_(UINT32,AddRef)               (THIS) PURE;

    STDMETHOD_(UINT32,Release)              (THIS) PURE;


    STDMETHOD_(UINT32, GetID)               (THIS) PURE;
    STDMETHOD(SetID)                        (THIS_
                                            UINT32 ulID) PURE;


    // IHXSessionStats methods.

    ///////////////////////////////////////////////////////////////////////////
    // Statistics accessor/mutator methods.
    //
    // Purpose:
    //      All used to either acquire a property value or set it.
    //
    // Arguments:
    //      Mutators take an IN parameter, the new value to set the property
    //      to. Accessors take nothing.
    ///////////////////////////////////////////////////////////////////////////

    STDMETHOD_(IHXClientStats*, GetClient) (THIS) PURE;
    STDMETHOD(SetClient)                    (THIS_ 
                                            IHXClientStats* pClient) PURE;

    STDMETHOD_(IHXBuffer*, GetHost)         (THIS) PURE;
    STDMETHOD(SetHost)                      (THIS_
                                            IHXBuffer* pHost) PURE;

    STDMETHOD_(IHXBuffer*, GetSessionStartTime) (THIS) PURE;
    STDMETHOD(SetSessionStartTime)              (THIS_
                                                IHXBuffer* pSessionStartTime) PURE;

    STDMETHOD_(IHXBuffer*, GetURL)          (THIS) PURE;
    STDMETHOD(SetURL)                       (THIS_
                                             IHXBuffer* pURL)       PURE;

    STDMETHOD_(IHXBuffer*, GetLogURL)          (THIS) PURE;
    STDMETHOD(SetLogURL)                       (THIS_
                                             IHXBuffer* pLogURL)       PURE;

    STDMETHOD_(IHXBuffer*, GetLogStats)     (THIS) PURE;
    STDMETHOD(SetLogStats)                  (THIS_
                                            IHXBuffer* pLogStats) PURE;

    STDMETHOD_(IHXBuffer*, GetPlayerRequestedURL)   (THIS) PURE;
    STDMETHOD(SetPlayerRequestedURL)                (THIS_
                                                    IHXBuffer* pPlayerRequestedURL) PURE;

    STDMETHOD_(IHXBuffer*, GetSalt)         (THIS) PURE;
    STDMETHOD(SetSalt)                      (THIS_
                                            IHXBuffer* pSalt) PURE;

    STDMETHOD_(IHXBuffer*, GetAuth)         (THIS) PURE;
    STDMETHOD(SetAuth)                      (THIS_
                                            IHXBuffer* pAuth) PURE;

    STDMETHOD_(IHXBuffer*, GetProxyConnectionType)   (THIS) PURE;
    STDMETHOD(SetProxyConnectionType)                (THIS_
                                                     IHXBuffer* pProxyConnectionType) PURE;

    STDMETHOD_(IHXBuffer*, GetInterfaceAddr)    (THIS) PURE;
    STDMETHOD(SetInterfaceAddr)                 (THIS_
                                                IHXBuffer* pInterfaceAddr) PURE;



    STDMETHOD_(UINT64, GetFileSize)         (THIS) PURE;
    STDMETHOD(SetFileSize)                  (THIS_
                                            UINT64 ulFileSize) PURE;

    STDMETHOD_(UINT32, GetStatus)            (THIS) PURE;
    STDMETHOD(SetStatus)                    (THIS_
                                            UINT32 ulHTTPStatus) PURE;

    STDMETHOD_(SessionStatsEndStatus, GetEndStatus)   (THIS) PURE;
    STDMETHOD(SetEndStatus)                 (THIS_
                                            SessionStatsEndStatus ulEndStatus) PURE;

    STDMETHOD_(UINT32, GetDuration)         (THIS) PURE;
    STDMETHOD(SetDuration)                  (THIS_
                                            UINT32 ulDuration) PURE;

    STDMETHOD_(UINT32, GetAvgBitrate)       (THIS) PURE;
    STDMETHOD(SetAvgBitrate)                (THIS_
                                            UINT32 ulAvgBitrate) PURE;

    STDMETHOD_(UINT32, GetSendingTime)      (THIS) PURE;
    STDMETHOD(SetSendingTime)               (THIS_
                                            UINT32 ulSendingTime) PURE;

    STDMETHOD_(UINT32, GetPlayTime)         (THIS) PURE;
    STDMETHOD(SetPlayTime)                  (THIS_
                                            UINT32 ulPlayTime) PURE;

    STDMETHOD_(BOOL, IsUDP)                 (THIS) PURE;
    STDMETHOD(SetUDP)                       (THIS_
                                             BOOL bIsUDP) PURE;

    STDMETHOD_(BOOL, IsRVStreamFound)                 (THIS) PURE;
    STDMETHOD(SetRVStreamFound)                       (THIS_
                                             BOOL bIsRVStreamFound) PURE;

    STDMETHOD_(BOOL, IsRAStreamFound)                 (THIS) PURE;
    STDMETHOD(SetRAStreamFound)                       (THIS_
                                             BOOL bIsRAStreamFound) PURE;

    STDMETHOD_(BOOL, IsREStreamFound)                 (THIS) PURE;
    STDMETHOD(SetREStreamFound)                       (THIS_
                                             BOOL bIsREStreamFound) PURE;

    STDMETHOD_(BOOL, IsRIStreamFound)                 (THIS) PURE;
    STDMETHOD(SetRIStreamFound)                       (THIS_
                                             BOOL bIsRIStreamFound) PURE;

    STDMETHOD_(BOOL, IsMulticastUsed)       (THIS) PURE;
    STDMETHOD(SetMulticastUsed)             (THIS_
                                            BOOL bIsMulticastUsed) PURE;

    STDMETHOD_(UINT16, GetXWapProfileStatus) (THIS) PURE;
    STDMETHOD(SetXWapProfileStatus)         (THIS_ 
                                            UINT16 unXWapProfileStatus) PURE;

    STDMETHOD(GetClientProfileInfo)         (THIS_  
                                            REF(IHXClientProfileInfo*) pInfo) PURE;
    STDMETHOD(SetClientProfileInfo)         (THIS_  
                                            IHXClientProfileInfo* pInfo) PURE;

    STDMETHOD_(IHXBuffer*, GetClientProfileURIs)    (THIS) PURE;
    STDMETHOD(SetClientProfileURIs)                 (THIS_ 
                                                    IHXBuffer* pURIs) PURE;

    STDMETHOD_(IHXQoSTransportAdaptationInfo*, GetQoSTransportAdaptationInfo)       (THIS) PURE;
    STDMETHOD(SetQoSTransportAdaptationInfo)                                        (THIS_
                                                                                     IHXQoSTransportAdaptationInfo* pInfo) PURE;

    STDMETHOD_(IHXQoSSessionAdaptationInfo*, GetQoSSessionAdaptationInfo)       (THIS) PURE;
    STDMETHOD(SetQoSSessionAdaptationInfo)                                      (THIS_
                                                                                 IHXQoSSessionAdaptationInfo* pInfo) PURE;

    STDMETHOD_(IHXQoSApplicationAdaptationInfo*, GetQoSApplicationAdaptationInfo)       (THIS) PURE;
    STDMETHOD(SetQoSApplicationAdaptationInfo)                                          (THIS_
                                                                                         IHXQoSApplicationAdaptationInfo* pInfo) PURE;

};



///////////////////////////////////////////////////////////////////////////////
// Interface: 
//
//      IHXClientStats
//
// Purpose:
//
//      Allows access to client statistics. 
//
// IID_IHXClientStats:
//
//      {83CE47E8-3EBE-450a-BF49-66D88094E516}
//
///////////////////////////////////////////////////////////////////////////////

// {83CE47E8-3EBE-450a-BF49-66D88094E516}
DEFINE_GUID(IID_IHXClientStats, 0x83ce47e8, 0x3ebe, 0x450a, 
            0xbf, 0x49, 0x66, 0xd8, 0x80, 0x94, 0xe5, 0x16);

#define CLSID_IHXClientStats     IID_IHXClientStats

#undef  INTERFACE
#define INTERFACE   IHXClientStats

DECLARE_INTERFACE_(IHXClientStats, IUnknown)
{

    // IUnknown methods

    STDMETHOD(QueryInterface)               (THIS_
                                            REFIID riid,
                                            void** ppvObj) PURE;

    STDMETHOD_(UINT32,AddRef)               (THIS) PURE;
 
    STDMETHOD_(UINT32,Release)              (THIS) PURE;


    // IHXClientStats methods

    STDMETHOD_(IHXClientStatsManager*, GetStatsManager) (THIS) PURE;
    STDMETHOD(SetStatsManager) (THIS_ IHXClientStatsManager* pStatsMgr) PURE;

    ///////////////////////////////////////////////////////////////////////////
    // Statistics accessor/mutator methods.
    //
    // Purpose:
    //      All used to either acquire a property value or set it.
    //
    // Arguments:
    //      Mutators take an IN parameter, the new value to set the property
    //      to. Accessors take nothing.
    ///////////////////////////////////////////////////////////////////////////

    STDMETHOD_(IHXBuffer*, GetIPAddress)    (THIS) PURE;
    STDMETHOD(SetIPAddress)                 (THIS_
                                            IHXBuffer* pIPAddress) PURE;

    STDMETHOD_(IHXBuffer*, GetCBID)         (THIS) PURE;
    STDMETHOD(SetCBID)                      (THIS_
                                            IHXBuffer* pCBID) PURE;

    STDMETHOD_(IHXBuffer*, GetGUID)         (THIS) PURE;
    STDMETHOD(SetGUID)                      (THIS_
                                            IHXBuffer* pGUID) PURE;