开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
hxplay.h
资源名称：142_61_thumb_advanced.rar　[点击查看]
上传用户：dangjiwu
上传日期：2013-07-19
资源大小：42019k
文件大小：54k
源码类别：

Symbian

开发平台：

Visual C++

hxplay.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxplay.h,v 1.18.8.1 2004/07/09 02:05:40 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  50. #ifndef _HXPLAYER_
  51. #define _HXPLAYER_
  53. #include "hxtypes.h"
  54. #include "hxcomm.h" // IHXRegistryID
  55. #include "hxfiles.h"
  56. #include "hxsmbw.h"
  57. #include "hxresult.h"
  58. #include "hxslist.h"
  59. #include "chxelst.h"
  60. #include "hxmap.h"
  61. #include "chxpckts.h"
  62. #include "hxurl.h"
  63. #include "hxtick.h"
  64. #include "hxmon.h"
  65. #include "hxclreg.h"
  66. #include "statinfo.h"
  67. #include "strminfo.h"
  68. #include "hxauth.h"
  69. #include "hxpreftr.h"
  70. #include "hxvsrc.h"
  72. //#include "prefkeys.h"
  73. #include "plprefk.h"
  74. //#include "domain.h"  // Needed for domain object
  76. #include "timeval.h"
  77. #include "hxausvc.h"
  78. #include "hxpends.h"
  79. #include "hxerror.h"
  80. #include "hxmeta.h"
  81. #include "chxphook.h"
  82. #include "hxwin.h"
  83. #include "hxcorgui.h"
  84. #include "smartptr.h"
  85. #include "miscsp.h"
  86. #include "hxrquest.h"
  87. #include "perscmgr.h"
  88. #include "hxbsrc.h"
  89. #include "hxsrc.h"
  90. #include "hxcbobj.h"
  92. #ifdef _SYMBIAN
  93. //XXXgfw Wow, symbian's unistd.h #defines remove to be unlink.
  94. //Very uncool.
  95. #undef remove
  96. #endif
  98. // forward decl.
  99. _INTERFACE IHXPlayer;
  100. _INTERFACE IHXPlayer2;
  101. _INTERFACE IHXAudioPlayerResponse;
  102. _INTERFACE IHXClientEngine;
  103. _INTERFACE IHXRenderer;
  104. _INTERFACE IHXScheduler;
  105. _INTERFACE IHXClientAdviseSink;
  106. _INTERFACE IHXMetaTrack;
  107. _INTERFACE IHXMetaLayout;
  108. _INTERFACE IHXErrorMessages;
  109. _INTERFACE IHXPreferences;
  110. _INTERFACE IHXHyperNavigate;
  111. _INTERFACE IHXAuthenticationManager;
  112. _INTERFACE IHXSiteSupplier;
  113. _INTERFACE IHXSiteLayout;
  114. _INTERFACE IHXUpgradeCollection;
  115. _INTERFACE IHXGroupSink;
  116. _INTERFACE IHXGroup;
  117. _INTERFACE IHXPlayerState;
  118. _INTERFACE IHXProxyManager;
  119. _INTERFACE IHXViewSourceCommand;
  120. _INTERFACE IHXViewPortManager;
  121. #if defined(HELIX_FEATURE_MEDIAMARKER)
  122. _INTERFACE IHXMediaMarkerManager;
  123. #endif /* #if defined(HELIX_FEATURE_MEDIAMARKER) */
  124. #if defined(HELIX_FEATURE_EVENTMANAGER)
  125. _INTERFACE IHXEventManager;
  126. #endif /* #if defined(HELIX_FEATURE_EVENTMANAGER) */
  127. _INTERFACE IHXPlayerNavigator;
  128. _INTERFACE IHXClientRequestSink;
  130. class CHXSiteManager;
  132. class CHXAudioPlayer;
  133. class HXClientEngine;
  134. class HXSource;
  135. class HXFileSource;
  136. class HXNetSource;
  137. class HXStream;
  139. class HXPlayerCallback;
  140. class UpdateStatsCallback;
  141. class CHXAdviseSinkControl;
  142. class CHXErrorSinkControl;
  143. class HXCookies;
  145. class Timeline;
  146. class Timeval;
  147. class HXMutex;
  149. class Plugin2Handler;
  150. struct IHXPlugin2Handler;
  153. class HXPersistentComponentManager;
  154. class HXPreferredTransportManager;
  156. #ifdef _UNIX
  157. _INTERFACE IHXSiteEventHandler;
  158. #endif
  160. struct STREAM_INFO;
  162. typedef ULONG32 BufferingReason;
  164. struct RendererInfo;
  165. class  SourceInfo;
  166. class HXPlayer;
  167. class UpdateStatsCallback;
  168. class HXPlayerCallback;
  169. class HXBasicGroupManager;
  170. class HXAdvancedGroupManager;
  171. class NextGroupManager;
  172. class PrefetchManager;
  173. class HXMasterTAC;
  174. class PlayerHyperNavigate;
  176. struct IHXBandwidthManager;
  178. class CHXEvent;
  179. class CHXSimpleList;
  180. class CHXMapStringToOb;
  181. class HXViewPortManager;
  182. #if defined(HELIX_FEATURE_MEDIAMARKER)
  183. class CHXMediaMarkerManager;
  184. #endif /* #if defined(HELIX_FEATURE_MEDIAMARKER) */
  185. #if defined(HELIX_FEATURE_EVENTMANAGER)
  186. class CRendererEventManager;
  187. #endif /* #if defined(HELIX_FEATURE_EVENTMANAGER) */
  189. #define DEFAULT_TIMESYNC_GRANULARITY 100
  190. /* Lowest allowable time sync granularity */
  191. #define MINIMUM_TIMESYNC_GRANULARITY 20
  193. #ifndef _WIN16
  194. //#if defined(HELIX_FEATURE_AUTHENTICATION)
  195. typedef WRAPPED_POINTER(IUnknown) Wrapped_IUnknown;
  197. class _CListOfWrapped_IUnknown_Node
  198. {
  199. #ifdef HELIX_FEATURE_AUTHENTICATION
  200. public:
  201.     _CListOfWrapped_IUnknown_Node();
  202.     ~_CListOfWrapped_IUnknown_Node();
  204.     Wrapped_IUnknown& value();
  205.     const Wrapped_IUnknown& value() const;
  206.     void value(const Wrapped_IUnknown& rclsNewValue);
  207.     _CListOfWrapped_IUnknown_Node& operator=(const Wrapped_IUnknown& rclsNewValue); 
  208.     _CListOfWrapped_IUnknown_Node* next() const;
  209.     void next(_CListOfWrapped_IUnknown_Node* plocnNew);
  210.     _CListOfWrapped_IUnknown_Node* prev() const;
  211.     void prev(_CListOfWrapped_IUnknown_Node* plocnNew);
  212.     void Remove();
  213.     void Insert(_CListOfWrapped_IUnknown_Node& rlocnNew);
  215. protected:
  216.     Wrapped_IUnknown m_clsValue;
  217.     _CListOfWrapped_IUnknown_Node* m_plocPrev;
  218.     _CListOfWrapped_IUnknown_Node* m_plocNext;
  219.     _CListOfWrapped_IUnknown_Node(const _CListOfWrapped_IUnknown_Node& rlocnOther){}
  220. #endif /* HELIX_FEATURE_AUTHENTICATION */
  221. };
  223. class _CListIteratorWrapped_IUnknown_;
  224. class _CListReverseIteratorWrapped_IUnknown_;
  226. class _CListOfWrapped_IUnknown_
  227. {
  228. public:
  229.     typedef _CListIteratorWrapped_IUnknown_ iterator;
  230.     typedef _CListReverseIteratorWrapped_IUnknown_ reverse_iterator;
  231.     typedef const _CListReverseIteratorWrapped_IUnknown_ const_reverse_iterator;
  233. #ifdef HELIX_FEATURE_AUTHENTICATION
  234.     _CListOfWrapped_IUnknown_();
  235.     _CListOfWrapped_IUnknown_(const _CListOfWrapped_IUnknown_& rlocOther);
  236.     ~_CListOfWrapped_IUnknown_();
  237.     _CListOfWrapped_IUnknown_& operator=(const _CListOfWrapped_IUnknown_& rlocOther); 
  239.     iterator begin();
  240.     const iterator begin() const;
  241.     iterator end();
  242.     const iterator end() const;
  244.     reverse_iterator rbegin();
  245.     const reverse_iterator rbegin() const;
  246.     reverse_iterator rend();
  247.     const reverse_iterator rend() const;
  249.     iterator insert(iterator itBefore, const Wrapped_IUnknown&);
  250.     void insert
  251.     (
  252. iterator itBefore,
  253. const iterator itFirst,
  254. const iterator itLast
  255.     );
  256.     void remove(iterator itThis);
  257.     void remove(iterator itFirst, iterator itLast);
  259.     void empty();
  261. protected:
  262.     _CListOfWrapped_IUnknown_Node m_locnREnd;
  263.     _CListOfWrapped_IUnknown_Node m_locnEnd;
  265.     void _copy(const _CListOfWrapped_IUnknown_& rlocOther);
  266. #endif /* HELIX_FEATURE_AUTHENTICATION */
  267. };
  269. class _CListIteratorWrapped_IUnknown_
  270. {
  271. #ifdef HELIX_FEATURE_AUTHENTICATION
  272. public:
  273.     _CListIteratorWrapped_IUnknown_();
  274.     _CListIteratorWrapped_IUnknown_
  275.     (
  276.         const _CListOfWrapped_IUnknown_Node& rlocnNewLocation
  277.     );
  278.     _CListIteratorWrapped_IUnknown_(const _CListIteratorWrapped_IUnknown_& rliocOther);
  279.     ~_CListIteratorWrapped_IUnknown_();
  281.     _CListIteratorWrapped_IUnknown_& operator=
  282.     (
  283. const _CListIteratorWrapped_IUnknown_& rliocOther
  284.     );
  286.     Wrapped_IUnknown& operator*();
  287.     _CListIteratorWrapped_IUnknown_& operator=(const Wrapped_IUnknown& rclsNewValue);
  289.     _CListIteratorWrapped_IUnknown_& operator++();
  290.     const _CListIteratorWrapped_IUnknown_ operator++(int);
  292.     _CListIteratorWrapped_IUnknown_& operator--();
  293.     const _CListIteratorWrapped_IUnknown_ operator--(int);
  295. private:
  296.     _CListOfWrapped_IUnknown_Node* m_plocCurrent;
  298.     friend class _CListOfWrapped_IUnknown_;
  299.     friend BOOL operator==
  300.     (
  301. const _CListIteratorWrapped_IUnknown_& rliocLeft,
  302. const _CListIteratorWrapped_IUnknown_& rliocRight
  303.     );
  304.     friend BOOL operator!=
  305.     (
  306. const _CListIteratorWrapped_IUnknown_& rliocLeft,
  307. const _CListIteratorWrapped_IUnknown_& rliocRight
  308.     );
  309. #endif /* HELIX_FEATURE_AUTHENTICATION */
  310. };
  312. #ifdef HELIX_FEATURE_AUTHENTICATION
  313. BOOL operator==
  314. (
  315.     const _CListIteratorWrapped_IUnknown_& rliocLeft,
  316.     const _CListIteratorWrapped_IUnknown_& rliocRight
  317. );
  319. BOOL operator!=
  320. (
  321.     const _CListIteratorWrapped_IUnknown_& rliocLeft,
  322.     const _CListIteratorWrapped_IUnknown_& rliocRight
  323. );
  324. #endif /* HELIX_FEATURE_AUTHENTICATION */
  326. class _CListReverseIteratorWrapped_IUnknown_
  327. {
  328. #ifdef HELIX_FEATURE_AUTHENTICATION
  329. public:
  330.     _CListReverseIteratorWrapped_IUnknown_();
  331.     _CListReverseIteratorWrapped_IUnknown_
  332.     (
  333.         const _CListOfWrapped_IUnknown_Node& rlocnNewLocation
  334.     );
  335.     _CListReverseIteratorWrapped_IUnknown_
  336.     (
  337. const _CListReverseIteratorWrapped_IUnknown_& rlriocOther
  338.     );
  339.     ~_CListReverseIteratorWrapped_IUnknown_();
  341.     _CListReverseIteratorWrapped_IUnknown_& operator=
  342.     (
  343. const _CListReverseIteratorWrapped_IUnknown_& rlriocOther
  344.     );
  346.     Wrapped_IUnknown& operator*();
  347.     _CListReverseIteratorWrapped_IUnknown_& operator=(const Wrapped_IUnknown& rclsNewValue);
  349.     _CListReverseIteratorWrapped_IUnknown_& operator++();
  350.     const _CListReverseIteratorWrapped_IUnknown_ operator++(int);
  351.     _CListReverseIteratorWrapped_IUnknown_& operator--();
  352.     const _CListReverseIteratorWrapped_IUnknown_ operator--(int);
  354. private:
  355.     _CListOfWrapped_IUnknown_Node* m_plocCurrent;
  356.     friend class _CListOfWrapped_IUnknown_;
  357.     friend BOOL operator==
  358.     (
  359. const _CListReverseIteratorWrapped_IUnknown_& rlriocLeft,
  360. const _CListReverseIteratorWrapped_IUnknown_& rlriocRight
  361.     );
  362.     friend BOOL operator!=
  363.     (
  364. const _CListReverseIteratorWrapped_IUnknown_& rlriocLeft,
  365. const _CListReverseIteratorWrapped_IUnknown_& rlriocRight
  366.     );
  367. #endif /* HELIX_FEATURE_AUTHENTICATION */
  368. };
  370. #ifdef HELIX_FEATURE_AUTHENTICATION
  371. BOOL operator==
  372. (
  373.     const _CListReverseIteratorWrapped_IUnknown_& rlriocLeft,
  374.     const _CListReverseIteratorWrapped_IUnknown_& rlriocRight
  375. );
  376. BOOL operator!=
  377. (
  378.     const _CListReverseIteratorWrapped_IUnknown_& rlriocLeft,
  379.     const _CListReverseIteratorWrapped_IUnknown_& rlriocRight
  380. );     
  381. #endif /* HELIX_FEATURE_AUTHENTICATION */
  383. class _CHXAuthenticationRequests
  384. {
  385. public:
  386.     _CHXAuthenticationRequests();
  387.     ~_CHXAuthenticationRequests();
  389.     HX_RESULT Add
  390.     (
  391. HXPlayer* pPlayerRequester, 
  392. IHXAuthenticationManagerResponse* pAuthenticationManagerResponseRequester,
  393. IHXValues* pAuthenticationHeaderValues
  394.     );
  395.     HX_RESULT SatisfyPending
  396.     (
  397. HX_RESULT ResultStatus, 
  398. const char* pCharUser, 
  399. const char* pCharPassword
  400.     );
  401.     void     ClearPendingList();
  402. private:
  403.     _CListOfWrapped_IUnknown_ m_ListOfIUnknownRequesters;
  404.     HXMutex* m_pMutexProtectList;
  405.     BOOL m_bUIShowing;
  406. };
  407. //#endif /* HELIX_FEATURE_AUTHENTICATION */
  409. struct RedirectInfo
  410. {
  411.     RedirectInfo()
  412.     {
  413. m_nGroupID = 0;
  414. m_nTrackID = 0;
  415. m_pURL = NULL;
  416.     }
  418.     ~RedirectInfo()
  419.     {
  420. HX_VECTOR_DELETE(m_pURL);
  421.     }
  423.     UINT16  m_nGroupID;
  424.     UINT16  m_nTrackID;
  425.     char*   m_pURL;
  426. };
  428. struct PendingTrackInfo
  429. {
  430.     PendingTrackInfo(UINT16     uGroupIndex, 
  431.      UINT16     uTrackIndex,
  432.      IHXValues*    pTrack)
  433.     {
  434. m_uGroupIndex = uGroupIndex;
  435. m_uTrackIndex = uTrackIndex;
  436. m_pTrack = pTrack;
  437. m_pTrack->AddRef();
  438.     }
  440.     ~PendingTrackInfo()
  441.     {
  442. HX_RELEASE(m_pTrack);
  443.     }
  445.     UINT16    m_uGroupIndex;
  446.     UINT16    m_uTrackIndex;
  447.     IHXValues*   m_pTrack;
  448. };
  449. #endif /* _WIN16 */
  451. class HXPlayer :   public IHXPlayer, 
  452.     public IHXPlayer2,
  453.     public IHXAudioPlayerResponse,
  454.     public IHXPendingStatus,
  455.     public IHXErrorMessages,
  456.     public IHXAuthenticationManager,
  457.     public IHXAuthenticationManager2,
  458.     public IHXAuthenticationManagerResponse,
  459.     public IHXRegistryID,
  460.     public IHXGroupSink,
  461.     public IHXLayoutSiteGroupManager,
  462.     public IHXRendererUpgrade,
  463.     public IHXInternalReset,
  464.     public IHXPlayerState,
  465.     public IHXViewSourceCommand,
  466.     public IHXOverrideDefaultServices,
  467.     public IHXPlayerNavigator,
  468.     public IHXClientStatisticsGranularity,
  469.     public IHXPlayerPresentation,
  470.                     public IHXRecordManager
  471. {
  472. protected:
  473.     LONG32 m_lRefCount;
  474.     UINT32 m_ulRepeatedRegistryID;
  475.     UINT32 m_ulNextGroupRegistryID;
  476.     HX_RESULT m_LastError;
  477.     char* m_pLastUserString;
  478.     UINT8 m_LastSeverity;
  479.     UINT32 m_ulLastUserCode;
  480.     char* m_pLastMoreInfoURL;
  482. #if defined(HELIX_FEATURE_REGISTRY)    
  483.     // statistic variables
  484.     HXClientRegistry* m_pRegistry;
  485. #else
  486.     void* m_pRegistry;
  487. #endif /* HELIX_FEATURE_REGISTRY */
  489. #if defined(HELIX_FEATURE_STATS) && defined(HELIX_FEATURE_REGISTRY)
  490.     PLAYER_STATS* m_pStats;
  491.     UpdateStatsCallback* m_pUpdateStatsCallback;
  492. #else
  493.     void* m_pStats;
  494.     void* m_pUpdateStatsCallback;
  495. #endif /* HELIX_FEATURE_STATS && HELIX_FEATURE_REGISTRY */
  497.     CHXGenericCallback* m_pHXPlayerCallback;
  498.     CHXGenericCallback* m_pHXPlayerInterruptCallback;
  499.     CHXGenericCallback* m_pSetupCallback;
  500. #if defined(HELIX_FEATURE_AUTHENTICATION)
  501.     CHXGenericCallback* m_pAuthenticationCallback;
  502. #else
  503.     void* m_pAuthenticationCallback;
  504. #endif /* HELIX_FEATURE_AUTHENTICATION */
  505.     IHXValues* m_pAutheticationValues;
  507.     ULONG32 m_ulStatsGranularity;
  509. public:
  510.     HXClientEngine* m_pEngine;
  511.     IHXPlugin2Handler* m_pPlugin2Handler;
  512. protected:
  513.     IUnknown* m_pClient;
  514.     CHXAudioPlayer* m_pAudioPlayer;
  515.     
  516.     CHXAdviseSinkControl* m_pAdviseSink;
  517.     CHXErrorSinkControl*   m_pErrorSinkControl;
  518.     
  519.     IHXClientRequestSink* m_pClientRequestSink;
  520.     IHXPreferences* m_pPreferences;
  521. #if defined(HELIX_FEATURE_HYPER_NAVIGATE)
  522.     PlayerHyperNavigate* m_pHyperNavigate;
  523. #else
  524.     void* m_pHyperNavigate;
  525. #endif /* HELIX_FEATURE_HYPER_NAVIGATE */
  526. #if defined(HELIX_FEATURE_PACKETHOOKMGR)
  527.     IHXPacketHookManager* m_pPacketHookManager;
  528. #else
  529.     void* m_pPacketHookManager;
  530. #endif /* HELIX_FEATURE_PACKETHOOKMGR */
  532. #if defined(HELIX_FEATURE_ADVANCEDGROUPMGR)
  533.     HXAdvancedGroupManager*     m_pGroupManager;
  534. #else
  535.     HXBasicGroupManager* m_pGroupManager;
  536. #endif /* HELIX_FEATURE_ADVANCEDGROUPMGR */
  538.     HXMasterTAC* m_pMasterTAC;
  540.     CHXSimpleList* m_pRedirectList;
  542.     IHXClientViewSource* m_pClientViewSource;
  543.     IHXClientViewRights* m_pClientViewRights;
  544.     IHXViewPortManager* m_pViewPortManager;
  545. #if defined(HELIX_FEATURE_MEDIAMARKER)
  546.     CHXMediaMarkerManager*     m_pMediaMarkerManager;
  547. #else
  548.     void* m_pMediaMarkerManager;
  549. #endif /* #if defined(HELIX_FEATURE_MEDIAMARKER) */
  550. #if defined(HELIX_FEATURE_EVENTMANAGER)
  551.     CRendererEventManager*      m_pEventManager;
  552. #else
  553.     void* m_pEventManager;
  554. #endif /* #if defined(HELIX_FEATURE_EVENTMANAGER) */
  555.     HXCookies* m_pCookies;
  557. #if defined(HELIX_FEATURE_NESTEDMETA)
  558.     HXPersistentComponentManager*  m_pPersistentComponentManager;
  559. #else
  560.     void* m_pPersistentComponentManager;
  561. #endif /* HELIX_FEATURE_NESTEDMETA */
  562.     HXPreferredTransportManager*   m_pPreferredTransportManager;
  563.     IHXNetInterfaces*     m_pNetInterfaces;
  565. public:
  566. HXPlayer();
  567. ~HXPlayer();
  569.     /*
  570.      * IUnknown methods
  571.      */
  572.     STDMETHOD(QueryInterface) (THIS_
  573. REFIID riid,
  574. void** ppvObj);
  576.     STDMETHOD_(ULONG32,AddRef) (THIS);
  578.     STDMETHOD_(ULONG32,Release) (THIS);
  580.     /*
  581.      * IHXPlayer methods
  582.      */
  584.     /************************************************************************
  585.      * Method:
  586.      * IHXPlayer::GetClientEngine
  587.      * Purpose:
  588.      * Get the interface to the client engine object of which the player
  589.      * is a part of.
  590.      *
  591.      */
  592.     STDMETHOD(GetClientEngine) (THIS_
  593.     REF(IHXClientEngine*) pEngine);
  595.     /************************************************************************
  596.      * Method:
  597.      * IHXPlayer::OpenURL
  598.      * Purpose:
  599.      * Tell the player to begin playback of all its sources.
  600.      *
  601.      */
  602.     STDMETHOD (OpenURL) (THIS_
  603.     const char* pURL);
  605.     /************************************************************************
  606.      * Method:
  607.      * IHXPlayer::Begin
  608.      * Purpose:
  609.      * Tell the player to begin playback of all its sources.
  610.      *
  611.      */
  612.     STDMETHOD (Begin) (THIS);
  614.     /************************************************************************
  615.      * Method:
  616.      * IHXPlayer::Stop
  617.      * Purpose:
  618.      * Tell the player to stop playback of all its sources.
  619.      *
  620.      */
  621.     STDMETHOD (Stop) (THIS);
  623.     /************************************************************************
  624.      * Method:
  625.      * IHXPlayer::Pause
  626.      * Purpose:
  627.      * Tell the player to pause playback of all its sources.
  628.      *
  629.      */
  630.     STDMETHOD (Pause) (THIS);
  632.     /************************************************************************
  633.      * Method:
  634.      * IHXPlayer::Seek
  635.      * Purpose:
  636.      * Tell the player to seek in the playback timeline of all its 
  637.      * sources.
  638.      *
  639.      */
  640.     STDMETHOD (Seek) (THIS_
  641. ULONG32 ulTime);
  643.     /************************************************************************
  644.      * Method:
  645.      *     IHXPlayer::GetSourceCount
  646.      * Purpose:
  647.      *     Returns the current number of source instances supported by
  648.      *     this player instance.
  649.      */
  650.     STDMETHOD_(UINT16, GetSourceCount)(THIS);
  652.     /************************************************************************
  653.      * Method:
  654.      *     IHXPlayer::GetSource
  655.      * Purpose:
  656.      *     Returns the Nth source instance supported by this player.
  657.      */
  658.     STDMETHOD(GetSource) (THIS_
  659. UINT16 nIndex,
  660. REF(IUnknown*) pUnknown);
  662.     /************************************************************************
  663.      * Method:
  664.      *     IHXPlayer::SetClientContext
  665.      * Purpose:
  666.      *     Called by the client to install itself as the provider of client
  667.      *     services to the core. This is traditionally called by the top 
  668.      *     level client application.
  669.      */
  670.     STDMETHOD(SetClientContext) (THIS_
  671. IUnknown* pUnknown);
  673.     /************************************************************************
  674.      * Method:
  675.      *     IHXPlayer::GetClientContext
  676.      * Purpose:
  677.      *     Called by the get the client context for this player. This is 
  678.      *     traditionally to determine called by top level client application.
  679.      */
  680.     STDMETHOD(GetClientContext) (THIS_
  681. REF(IUnknown*) pUnknown);
  683.     /************************************************************************
  684.      * Method:
  685.      * IHXPlayer::IsDone
  686.      * Purpose:
  687.      * Ask the player if it is done with the current presentation
  688.      *
  689.      */
  690.     STDMETHOD_ (BOOL,IsDone) (THIS);
  692.     /************************************************************************
  693.      * Method:
  694.      * IHXPlayer::IsLive
  695.      * Purpose:
  696.      * Ask the player whether it contains the live source
  697.      *
  698.      */
  699.     STDMETHOD_ (BOOL,IsLive) (THIS);
  701.     /************************************************************************
  702.      * Method:
  703.      * IHXPlayer::GetCurrentPlayTime
  704.      * Purpose:
  705.      * Get the current time on the Player timeline
  706.      *
  707.      */
  708.     STDMETHOD_ (ULONG32,GetCurrentPlayTime) (THIS);
  710.     /************************************************************************
  711.      * Method:
  712.      *     IHXPlayer::AddAdviseSink
  713.      * Purpose:
  714.      *     Call this method to add a client advise sink.
  715.      *
  716.      */
  717.     STDMETHOD(AddAdviseSink) (THIS_
  718. IHXClientAdviseSink* pAdviseSink);
  720.     /************************************************************************
  721.      * Method:
  722.      *     IHXPlayer::RemoveAdviseSink
  723.      * Purpose:
  724.      *     Call this method to remove a client advise sink.
  725.      */
  726.     STDMETHOD(RemoveAdviseSink) (THIS_
  727. IHXClientAdviseSink* pAdviseSink);
  729.     /************************************************************************
  730.      * Method:
  731.      *     IHXPlayer2::SetMinimumPreroll
  732.      * Purpose:
  733.      *     Call this method to set the minimum preroll of this clip
  734.      */
  735.     STDMETHOD(SetMinimumPreroll) (THIS_
  736. UINT32 ulMinPreroll);
  738.     /************************************************************************
  739.      * Method:
  740.      *     IHXPlayer2::GetMinimumPreroll
  741.      * Purpose:
  742.      *     Call this method to get the minimum preroll of this clip
  743.      */
  744.     STDMETHOD(GetMinimumPreroll) (THIS_
  745. REF(UINT32) ulMinPreroll);
  747.     /************************************************************************
  748.      * Method:
  749.      *     IHXPlayer2::OpenRequest
  750.      * Purpose:
  751.      *     Call this method to open the IHXRequest
  752.      */
  753.     STDMETHOD(OpenRequest) (THIS_
  754.     IHXRequest* pRequest);
  755.     
  756.     /************************************************************************
  757.      * Method:
  758.      *     IID_IHXPlayer2::GetRequest
  759.      * Purpose:
  760.      *     Call this method to get the IHXRequest
  761.      */
  762.     STDMETHOD(GetRequest) (THIS_
  763.    REF(IHXRequest*) pRequest);
  765.     /************************************************************************
  766.      * Method:
  767.      *     EventOccurred
  768.      * Purpose:
  769.      *     Clients call this to pass OS events to the player. HXxEvent
  770.      *     defines a cross-platform event.
  771.      */
  772.     void EventOccurred(HXxEvent* pEvent);
  774. #ifdef _UNIX
  775.     void CollectSelectInfo(INT32 *n, 
  776.    fd_set* readfds,
  777.    fd_set* writefds, 
  778.    fd_set* exceptfds,
  779.    struct timeval* tv);
  780.     void ProcessSelect(INT32* n,
  781.        fd_set* readfds,
  782.        fd_set* writefds, 
  783.        fd_set* exceptfds,
  784.        struct timeval* tv);
  785. #endif
  787.     /************************************************************************
  788.      * Method:
  789.      * GetInst
  790.      * Purpose:
  791.      * TBD
  792.      *
  793.      */
  794.     ULONG32 GetInst(void);
  796.     /************************************************************************
  797.      * Method:
  798.      * UpdateStatistics
  799.      * Purpose:
  800.      * Update statistics periodically
  801.      *
  802.      */
  803.     HX_RESULT UpdateStatistics(void);
  805.     /************************************************************************
  806.      * Method:
  807.      * ProcessIdle
  808.      * Purpose:
  809.      * Work-Horse for the player...
  810.      *
  811.      */
  812.     HX_RESULT ProcessIdle(void);
  814.     /************************************************************************
  815.      *  Method:
  816.      *      IHXAudioPlayerResponse::OnTimeSync
  817.      *  Purpose:
  818.      *      Notification interface provided by users of the IHXAudioPlayer 
  819.      *      interface. This method is called by the IHXAudioPlayer when 
  820.      *      audio playback occurs.
  821.      */
  822.     STDMETHOD(OnTimeSync)       (THIS_
  823. ULONG32 /*IN*/ ulTimeEnd);
  826.     /************************************************************************
  827.      * Method:
  828.      * HXPlayer::Init
  829.      * Purpose:
  830.      * Get the interface to the client engine object of which the player
  831.      * is a part of. It is not a part of IHXPlayer interface
  832.      *
  833.      */
  834.     STDMETHOD(Init) (THIS_
  835.  IHXClientEngine* pEngine,
  836.  UINT32 unRegistryID,
  837.  CHXAudioPlayer* pAudioPlayer);
  839.     /************************************************************************
  840.      * Method:
  841.      * HXPlayer::ReportError
  842.      * Purpose:
  843.      * The source object reports of any fatal errors. 
  844.      *
  845.      */
  846.     void ReportError (HXSource* pSource, 
  847. HX_RESULT theErr, const char* pUserString = NULL);
  849.     // IHXPendingStatus methods
  851.     /************************************************************************
  852.      * Method:
  853.      *     IHXPendingStatus::GetStatus
  854.      * Purpose:
  855.      *     Called by the user to get the current pending status from an object
  856.      */
  857.     STDMETHOD(GetStatus) (THIS_
  858. REF(UINT16) uStatusCode, 
  859. REF(IHXBuffer*) pStatusDesc, 
  860. REF(UINT16) ulPercentDone);
  862.     /************************************************************************
  863.      * Method:
  864.      *     HXPlayer::SetStatsGranularity
  865.      * Purpose:
  866.      *     Called by the user to set how often the statistics registry needs 
  867.      *     to be updated in ms
  868.      */
  869.     STDMETHOD(SetStatsGranularity) (THIS_
  870. ULONG32 ulGranularity);
  872.     /************************************************************************
  873.      * Method:
  874.      *     IHXPlayerPresentation::ClosePresentation
  875.      * Purpose:
  876.      *     Call this method to close the player's current presentation.  This will free
  877.      *     all resources associated with the current presentation.
  878.      */
  879.     STDMETHOD(ClosePresentation)    (THIS);
  881.     /*
  882.      * IHXErrorMessages methods
  883.      */
  885.     /************************************************************************
  886.      * Method:
  887.      *     IHXErrorMessages::Report
  888.      * Purpose:
  889.      *     Call this method to report an error, event, or status message.
  890.      */
  891.     STDMETHOD(Report) (THIS_
  892. const UINT8 unSeverity,  
  893. HX_RESULT ulHXCode,
  894. const ULONG32 ulUserCode,
  895. const char* pUserString,
  896. const char* pMoreInfoURL
  897. );
  899.     /************************************************************************
  900.      * Method:
  901.      *     IHXErrorMessages::GetErrorText
  902.      * Purpose:
  903.      *     Call this method to get the text description of a RMA error code.
  904.      * Parameters:
  905.      *     HX_RESULT ulHXCode
  906.      *      A RMA error code.
  907.      *  Return Value:
  908.      *     IHXBuffer* containing error text.
  909.      */
  910.     STDMETHOD_(IHXBuffer*, GetErrorText) (THIS_
  911. HX_RESULT ulHXCode
  912. );
  914.     /*
  915.      * IHXRegistryID methods
  916.      */
  918.     /************************************************************************
  919.      * Method:
  920.      *     IHXRegistryID::GetID
  921.      * Purpose:
  922.      *     Get registry ID(hash_key) of the objects(player, source and stream)
  923.      *
  924.      */
  925.     STDMETHOD(GetID) (THIS_
  926. REF(UINT32) /*OUT*/  ulRegistryID);
  928.     STDMETHOD(HandleAuthenticationRequest) 
  929.                                      (IHXAuthenticationManagerResponse*);
  930.     STDMETHOD(HandleAuthenticationRequest2)
  931.          (IHXAuthenticationManagerResponse*, IHXValues*);
  933.     // IHXAuthenticationManagerResponse
  934.     STDMETHOD(AuthenticationRequestDone)
  935.     (
  936. HX_RESULT HX_RESULTStatus,
  937. const char* pcharUser,
  938. const char* pcharPassword
  939.     );
  940.     
  941.     /*
  942.      *  IHXGroupSink methods
  943.      */
  944.     /************************************************************************
  945.     *  Method:
  946.     *      IHXGroupSink::GroupAdded
  947.     *  Purpose:
  948.     * Notification of a new group being added to the presentation.
  949.     */
  950.     STDMETHOD(GroupAdded)    (THIS_
  951.     UINT16      /*IN*/ uGroupIndex,
  952.     IHXGroup*     /*IN*/ pGroup);
  954.     /************************************************************************
  955.     *  Method:
  956.     *      IHXGroupSink::GroupRemoved
  957.     *  Purpose:
  958.     * Notification of a group being removed from the presentation.
  959.     */
  960.     STDMETHOD(GroupRemoved)    (THIS_
  961. UINT16      /*IN*/ uGroupIndex,
  962. IHXGroup*  /*IN*/ pGroup);
  964.     /************************************************************************
  965.     *  Method:
  966.     *      IHXGroupSink::AllGroupsRemoved
  967.     *  Purpose:
  968.     * Notification that all groups have been removed from the 
  969.     * current presentation.
  970.     */
  971.     STDMETHOD(AllGroupsRemoved)  (THIS);
  973.     /************************************************************************
  974.     *  Method:
  975.     *      IHXGroupSink::TrackAdded
  976.     *  Purpose:
  977.     * Notification of a new track being added to a group.
  978.     */
  979.     STDMETHOD(TrackAdded)  (THIS_
  980.     UINT16      /*IN*/ uGroupIndex,
  981.     UINT16      /*IN*/ uTrackIndex,
  982.     IHXValues*     /*IN*/ pTrack);
  984.     /************************************************************************
  985.     *  Method:
  986.     *      IHXGroupSink::TrackAdded
  987.     *  Purpose:
  988.     * Notification of a track being removed from a group.
  989.     */
  990.     STDMETHOD(TrackRemoved)    (THIS_
  991. UINT16  /*IN*/ uGroupIndex,
  992. UINT16  /*IN*/ uTrackIndex,
  993. IHXValues* /*IN*/ pTrack);
  995.     /************************************************************************
  996.     *  Method:
  997.     *      IHXGroupSink::TrackStarted
  998.     *  Purpose:
  999.     * Notification of a track being started in a group.
  1000.     */
  1001.     STDMETHOD(TrackStarted)    (THIS_
  1002. UINT16  /*IN*/ uGroupIndex,
  1003. UINT16  /*IN*/ uTrackIndex,
  1004. IHXValues* /*IN*/ pTrack);
  1006.     /************************************************************************
  1007.     *  Method:
  1008.     *      IHXGroupSink::TrackStopped
  1009.     *  Purpose:
  1010.     * Notification of a track being stopped in a group.
  1011.     */
  1012.     STDMETHOD(TrackStopped)    (THIS_
  1013. UINT16  /*IN*/ uGroupIndex,
  1014. UINT16  /*IN*/ uTrackIndex,
  1015. IHXValues* /*IN*/ pTrack);
  1017.    /************************************************************************
  1018.     *  Method:
  1019.     *      IHXGroupSink::CurrentGroupSet
  1020.     *  Purpose:
  1021.     * This group is being currently played in the presentation.
  1022.     */
  1023.     STDMETHOD(CurrentGroupSet) (THIS_
  1024. UINT16      /*IN*/ uGroupIndex,
  1025. IHXGroup*  /*IN*/ pGroup);
  1026.            
  1027.     /*
  1028.      * IHXLayoutSiteGroupManager methods
  1029.      */
  1030.     /************************************************************************
  1031.     *  Method:
  1032.     *      IHXLayoutSiteGroupManager::AddLayoutSiteGroup
  1033.     *  Purpose:
  1034.     * Add this LSG to the presentation
  1035.     */
  1036.     STDMETHOD(AddLayoutSiteGroup) (THIS_
  1037. IUnknown*  /*IN*/ pLSG);
  1039.     /************************************************************************
  1040.     *  Method:
  1041.     *      IHXLayoutSiteGroupManager::RemoveLayoutSiteGroup
  1042.     *  Purpose:
  1043.     * Remove this LSG from the presentation
  1044.     */
  1045.     STDMETHOD(RemoveLayoutSiteGroup) (THIS_
  1046. IUnknown*  /*IN*/ pLSG);
  1048.     /*
  1049.      * IHXRendererUpgrade methods
  1050.      */
  1051.     /************************************************************************
  1052.     *  Method:
  1053.     *      IHXRendererUpgrade::IsRendererAvailable
  1054.     *  Purpose:
  1055.     *    Is a renderer with this mime type already loaded?
  1056.     */
  1057.     STDMETHOD_(BOOL,IsRendererAvailable)(THIS_
  1058. const char* /*IN*/ pMimeType);
  1060.     /************************************************************************
  1061.     *  Method:
  1062.     *      IHXRendererUpgrade::ForceUpgrade
  1063.     *  Purpose:
  1064.     *    Force an upgrade of all renderers in list
  1065.     */
  1066.     STDMETHOD(ForceUpgrade) (THIS);
  1068.     /*
  1069.      * IHXInternalReset method
  1070.      */
  1071.     STDMETHOD(InternalReset) (THIS);
  1073.     /*
  1074.      * IHXPlayerState methods
  1075.      */
  1076.     STDMETHOD_(BOOL, IsPlaying)    (THIS) {return m_bIsPlaying;}
  1078.     /************************************************************************
  1079.      *  IHXViewSourceCommand methods
  1080.      */
  1081.     STDMETHOD_(BOOL, CanViewSource) (THIS_  
  1082. IHXStreamSource* pStream);
  1083.     STDMETHOD(DoViewSource) (THIS_
  1084. IHXStreamSource* pStream);
  1085.     STDMETHOD(GetViewSourceURL) (THIS_
  1086. IHXStreamSource*     pSource,
  1087. IHXViewSourceURLResponse*  pResp);
  1089.     /*
  1090.      * IHXOverrideDefaultServices methods
  1091.      */
  1093.     /************************************************************************
  1094.      *  Method:
  1095.      *      IHXOverrideDefaultServices::OverrideServices
  1096.      *  Purpose:
  1097.      *      Override default services provided by the G2 system.
  1098.      * 
  1099.      */
  1100.     STDMETHOD(OverrideServices)         (THIS_
  1101. IUnknown* pContext);
  1103.     /*
  1104.      * IHXPlayerNavigator methods
  1105.      */
  1107.     /************************************************************************
  1108.      * Method:
  1109.      *     IHXPlayerNavigator::AddChildPlayer
  1110.      * Purpose:
  1111.      *     Add child player to the current player
  1112.      */
  1113.     STDMETHOD(AddChildPlayer)     (THIS_
  1114.     IHXPlayer* pPlayer);
  1116.     /************************************************************************
  1117.      * Method:
  1118.      *     IHXPlayerNavigator::RemoveChildPlayer
  1119.      * Purpose:
  1120.      *     Remove child player from the current player
  1121.      */
  1122.     STDMETHOD(RemoveChildPlayer)    (THIS_
  1123.     IHXPlayer* pPlayer);
  1125.     /************************************************************************
  1126.      * Method:
  1127.      *     IHXPlayerNavigator::GetNumChildPlayer
  1128.      * Purpose:
  1129.      *     Get number of the child players
  1130.      */
  1131.     STDMETHOD_(UINT16, GetNumChildPlayer)    (THIS);
  1133.     /************************************************************************
  1134.      * Method:
  1135.      *     IHXPlayerNavigator::GetChildPlayer
  1136.      * Purpose:
  1137.      *     Get Nth child player
  1138.      */
  1139.     STDMETHOD(GetChildPlayer)     (THIS_
  1140.     UINT16 uPlayerIndex,
  1141.     REF(IHXPlayer*) pPlayer);
  1143.     /************************************************************************
  1144.      * Method:
  1145.      *     IHXPlayerNavigator::SetParentPlayer
  1146.      * Purpose:
  1147.      *     Set the parent player
  1148.      */
  1149.     STDMETHOD(SetParentPlayer)     (THIS_
  1150.     IHXPlayer* pPlayer);
  1152.     /************************************************************************
  1153.      * Method:
  1154.      *     IHXPlayerNavigator::RemoveParentPlayer
  1155.      * Purpose:
  1156.      *     Remove the parent player
  1157.      */
  1158.     STDMETHOD(RemoveParentPlayer)   (THIS_
  1159.     IHXPlayer* pPlayer);
  1161.     /************************************************************************
  1162.      * Method:
  1163.      *     IHXPlayerNavigator::GetParentPlayer
  1164.      * Purpose:
  1165.      *     Get the parent player
  1166.      */
  1167.     STDMETHOD(GetParentPlayer)     (THIS_
  1168.     REF(IHXPlayer*) pPlayer);
  1170.     /* 
  1171.      * IHXRecordManager methods 
  1172.      */ 
  1174.     /************************************************************************ 
  1175.      *  Method: 
  1176.      *      IHXRecordManager::LoadRecordService 
  1177.      *  Purpose: 
  1178.      *      Called by TLC to supply the Core with record service. 
  1179.      */ 
  1180.     STDMETHOD(LoadRecordService) (THIS_ IHXRecordService* pRecordService); 
  1182.     /************************************************************************ 
  1183.      *  Method: 
  1184.      *      IHXRecordManager::GetRecordService 
  1185.      *  Purpose: 
  1186.      *      return current record service for the Player. 
  1187.      */ 
  1188.     STDMETHOD(GetRecordService) (THIS_ REF(IHXRecordService*) pRecordService); 
  1190.     /************************************************************************ 
  1191.      *  Method: 
  1192.      *      IHXRecordManager::UnloadRecordService 
  1193.      *  Purpose: 
  1194.      *      Called by TLC to ask the Core to stop using record service. 
  1195.      */ 
  1196.     STDMETHOD(UnloadRecordService) (THIS); 
  1198.     ////////////////////////////////////////////////////////////////////
  1199.     //
  1200.     // The following members are related to meta-file support.
  1201.     //
  1202. public:
  1203.     void SetModal(BOOL bModal) {m_bSetModal = bModal;};
  1204.     HX_RESULT SetSingleURLPresentation(const CHXURL* pURL);
  1206.     HX_RESULT AddURL(SourceInfo*& pSourceInfo, BOOL bAltURL);
  1208.     void GetActiveRequest(IHXRequest*& pRequest)
  1209. {
  1210.     pRequest = NULL;     
  1212.     if (m_pRequest)
  1213.     {
  1214. #if defined(HELIX_FEATURE_NESTEDMETA)
  1215. // we want to keep the original copy of IHXRequest in SMIL/RAM
  1216. // so that individual source within will have a "clean" copy of 
  1217. // IHXRequest to start with
  1218. if (m_pPersistentComponentManager &&
  1219.     m_pPersistentComponentManager->m_pRootPersistentComponent &&
  1220.     !m_pPersistentComponentManager->m_pRootPersistentComponent->m_bToBeClosed)
  1221. {
  1222.     CHXRequest::CreateFromWithRequestHeaderOnly(m_pRequest, &pRequest);
  1223. }
  1224. else
  1225. #endif /* HELIX_FEATURE_NESTEDMETA */
  1226. if (m_bActiveRequest)
  1227. {
  1228.     pRequest = m_pRequest;
  1229.     pRequest->AddRef();
  1230. }
  1231.     }
  1232. };
  1234.     void ResetActiveRequest() {m_bActiveRequest = FALSE;};
  1236.     void SetGranularity(ULONG32 ulGranularity);
  1237.     ULONG32 GetGranularity(void) {return m_ulLowestGranularity;};
  1239.     HX_RESULT SetGranularity(HXSource* pSource, UINT16 uStreamNumber, 
  1240.        UINT32 ulGranularity);
  1242.     void                ClosePlayer(void);
  1243.     
  1244.     void InternalPause();
  1246.     HX_RESULT EventReady(HXSource* pSource, CHXEvent* pEvent);
  1248.     void ShutDown(void);
  1250.     void RegisterSourcesDone(void);
  1252.     BOOL IsInitialized(void) {return m_bInitialized;};
  1254.     BOOL CanBeStarted(HXSource* pSource, SourceInfo* pThisSourceInfo, BOOL bPartOfNextGroup);
  1255.     void EndOfSource(HXSource* pSource);
  1257.     BOOL CanBeFastStarted(SourceInfo* pSourceInfo);
  1258.     void SureStreamSourceRegistered(SourceInfo* pSourceInfo);
  1259.     void SureStreamSourceUnRegistered(SourceInfo* pSourceInfo);
  1261.     ULONG32 GetInternalCurrentPlayTime(void)
  1262.     { return m_ulCurrentPlayTime; };
  1264.     HX_RESULT HandleRedirectRequest(UINT16 nGroup, UINT16 nTrack, char* pURL);
  1265.     BOOL IsAtSourceMap(SourceInfo* pSourceInfo);
  1267.     HX_RESULT RepeatTrackAdded(UINT16 /*IN*/ uGroupIndex,
  1268.  UINT16 /*IN*/ uTrackIndex,
  1269.  IHXValues* /*IN*/ pTrack);
  1271.     /* Temporary function */
  1272.     void SetInterrupt(BOOL bUseCoreThread) 
  1273.     {m_bUseCoreThread = bUseCoreThread;};
  1274.     virtual HX_RESULT SendPacket(CHXEvent* pEvent);
  1275.     CHXAudioPlayer* GetAudioPlayer(void) {return m_pAudioPlayer;};
  1276.     INT32 GetCurrentGroupID(void) {return m_nCurrentGroup;};
  1277.     void                NotifyPlaybackEndToTLC() {m_bIsPresentationClosedToBeSent = TRUE;};
  1278.     HX_RESULT CopyRegInfo(UINT32 ulFromRegID, UINT32 ulToRegID);
  1280.     BOOL                IsSitePresent(IHXSite* pSite);
  1281.     void CheckIfRendererNeedFocus(IUnknown* pRenderer);
  1283.     static void         PlayerCallback(void *pParam);
  1284.     static void SetupCallback(void *pParam);
  1285. #if defined(HELIX_FEATURE_AUTHENTICATION)
  1286.     static void         AuthenticationCallback(void *pParam);
  1287. #endif
  1288.     
  1289.     friend class SourceInfo;
  1290.     friend class HXSource;
  1291.     friend class HXNetSource;
  1292.     friend class HXFileSource;
  1293.     friend class HXPersistentComponent;
  1294.     friend class HXPersistentComponentManager;
  1296. private:
  1297.     HX_BITFIELD m_bForceStatsUpdate : 1;
  1298.     HX_BITFIELD m_bActiveRequest : 1;
  1299.     HX_BITFIELD m_bAddLayoutSiteGroupCalled : 1;
  1300.     HX_BITFIELD m_bDoRedirect : 1;
  1301.     HX_BITFIELD m_bFastStartCheckDone : 1;
  1302.     HX_BITFIELD m_bFastStart : 1;
  1304.     TurboPlayOffReason m_turboPlayOffReason;
  1306.     UINT32 m_ulActiveSureStreamSource;
  1308.     INT32 m_nCurrentGroup;
  1309.     INT32 m_nGroupCount;
  1311.     HX_RESULT DoOpenGroup(UINT16 nGroupNumber);
  1312.     HX_RESULT OpenTrack(IHXValues* pTrack, UINT16 uGroupID, UINT16 uTrackID);
  1313.     void PlayNextGroup();
  1315.     BOOL CheckTrackAndSourceOnTrackStarted(INT32 nGroup, INT32 nTrack, UINT32 sourceID);
  1317.     BOOL GetViewSourceStream(REF(IHXStreamSource*) pStrmSource);
  1318.     BOOL AreAllPacketsSent();
  1320.     HX_RESULT GetSourceInfo(UINT16 uGroupIndex, UINT16 uTrackIndex, SourceInfo*& pSourceInfo);
  1321.     HX_RESULT UpdateTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues);
  1322.     HX_RESULT RemoveTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues);
  1323.     HX_RESULT AddPrefetchTrack(UINT16 uGroupIndex, UINT16 uPrefetchTrackIndex, IHXValues* pValues);
  1324.     HX_RESULT UpdatePrefetchTrack(UINT16 uGroupIndex, UINT16 uPrefetchTrackIndex, IHXValues* pValues);
  1325.     HX_RESULT RemovePrefetchTrack(UINT16 uGroupIndex, UINT16 uPrefetchTrackIndex, IHXValues* pValues);
  1326.     HX_RESULT PrefetchTrackDone(UINT16 uGroupIndex, UINT16 uPrefetchTrackIndex, HX_RESULT status);
  1328.     HX_RESULT BeginTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues);    
  1329.     HX_RESULT PauseTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues);
  1330.     HX_RESULT SeekTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues, UINT32 ulSeekTime);    
  1331.     HX_RESULT StopTrack(UINT16 uGroupIndex, UINT16 uTrackIndex, IHXValues* pValues);    
  1332.     HX_RESULT SetSoundLevel(UINT16 uGroupIndex, UINT16 uTrackIndex, UINT16 uSoundLevel, BOOL bReflushAudioDevice);    
  1334.     void                CheckSourceRegistration(void);
  1335.     void                GetTimingFromURL(CHXURL* pURL, UINT32& ulStart, UINT32& ulEnd, UINT32& ulDelay, UINT32& ulDuration);
  1337. #if defined(HELIX_FEATURE_RECORDCONTROL)
  1338.     BOOL                IsRecordServiceEnabled();
  1339. #endif
  1341. protected:
  1342.     CHXSimpleList* m_pAltURLs;
  1343.     CHXURL* m_pURL;
  1344.     IHXRequest* m_pRequest;
  1346.     HX_RESULT AdjustSeekOnRepeatedSource(SourceInfo* pSourceInfo, 
  1347.    UINT32 ulSeekTime);
  1349.     HX_RESULT  DoNetworkOpen(SourceInfo*& pSourceInfo, BOOL bAltURL);
  1350.     HX_RESULT  DoFileSystemOpen(SourceInfo*& pSourceInfo, BOOL bAltURL);
  1352.     HX_RESULT CreateSourceInfo(SourceInfo*& pSourceInfo, BOOL bAltURL);
  1353.     HX_RESULT PrepareSourceInfo(IHXValues* pTrack, SourceInfo*& pSourceInfo);
  1354.     HX_RESULT DoURLOpen(CHXURL* pURL, char* pMimeType);
  1355.     HX_RESULT DoAltURL(void);
  1356.     HX_RESULT DoAltURLOpen(char* pURL, BOOL bDefault, SourceInfo* pMainSourceInfo);
  1357.     HX_RESULT SpawnSourceIfNeeded(SourceInfo* pSourceInfo);
  1358.     HX_RESULT SwitchSourceIfNeeded(void);
  1360.     HX_RESULT DoRedirect(void);
  1361.     HX_RESULT OpenRedirect(const char* pszURL);
  1363.     HX_RESULT InitializeRenderers(void);
  1365.     HX_RESULT LayoutRenderers(void);
  1366.     virtual HX_RESULT ProcessIdleExt(void);
  1368.     void CreateDefaultRendererWindow
  1369.     (
  1370. RendererInfo*     pRInfo,
  1371. IHXRenderer*     pRend,
  1372. IHXBuffer*     pDisplayInfo,
  1373. const char*     pName
  1374.     );
  1375.     void CreateLayoutWindow
  1376.     (
  1377. IHXMetaLayout* pLayout
  1378.     );
  1380.     /************************************************************************
  1381.      * Method:
  1382.      * ExecuteCurrentEvents
  1383.      * Purpose:
  1384.      * Send any due packets to the renderers
  1385.      *
  1386.      */
  1387.     HX_RESULT ProcessCurrentEvents(void);
  1389.     /************************************************************************
  1390.      * Method:
  1391.      * DeleteAllEvents
  1392.      * Purpose:
  1393.      * Remove all pending events due to seek/stop.
  1394.      *
  1395.      */
  1396.     HX_RESULT DeleteAllEvents(void);
  1397.     HX_RESULT SendPreSeekEvents(void);
  1398.     void StopAllStreams(EndCode endCode = END_STOP);
  1399.     
  1400.     virtual HX_RESULT SendPreSeekEventsExt(void);         
  1401.     virtual HX_RESULT StopAllStreamsExt(EndCode endCode = END_STOP);
  1402.     
  1403.     virtual SourceInfo*     NewSourceInfo(void);
  1404.     virtual HXFileSource*  NewFileSource(void);
  1405.     virtual HXNetSource*   NewNetSource(void);
  1406.     virtual HX_RESULT     OpenTrackExt(void);
  1408.     void CloseAllRenderers(INT32 nGroupSwitchTo);
  1409.     HX_RESULT UnRegisterCurrentSources(void);
  1411.     HX_RESULT SetupAllStreams(void);
  1412.     void ResetPlayer(void);
  1413.     void ResetGroup(void);
  1414.     void SetMinimumPushdown(void);
  1415.     void SchedulePlayer(void);
  1416.     HX_RESULT CheckForAudioResume(void);
  1418.     HX_RESULT InitializeNetworkDrivers(void);
  1420.     inline void UpdateCurrentPlayTime( ULONG32 ulCurrentPlayTime );
  1421.     
  1422.     HX_RESULT ActualReport(
  1423.     const UINT8 unSeverity,  
  1424.     HX_RESULT ulHXCode,
  1425.     const ULONG32 ulUserCode,
  1426.     const char* pUserString,
  1427.     const char* pMoreInfoURL);
  1429.     IHXPendingStatus* m_pMetaSrcStatus;
  1431.     // list of sources
  1432.     CHXMapPtrToPtr* m_pSourceMap;
  1433.     CHXSimpleList* m_pPendingTrackList;
  1435.     // current time on the timeline for this player..
  1436.     // this would either be updated by the audio services of any rendering object
  1437.     // happens to be an audio renderer and decides to use our audio services...
  1438.     // ELSE it will be updated by a timer object... 
  1439.     ULONG32 m_ulCurrentPlayTime;
  1440.     
  1441. #if defined(_MACINTOSH) || defined(_MAC_UNIX)
  1442.     // this tracks the current timeline for this player, with the caveat
  1443.     // that it's only updated when the current play time is updated at
  1444.     // system time. This is useful for deciding whether to allocated "extra"
  1445.     // time to the player or giving it back to the system -- a pretty
  1446.     // complicated issue on MacOS 8.
  1447.     ULONG32 m_ulCurrentSystemPlayTime;
  1448. #endif
  1450.     
  1451.     // Length of all sources!
  1452.     ULONG32 m_ulPresentationDuration;
  1454.     // used to inform renderers the pre and post seek info..
  1455.     ULONG32 m_ulTimeBeforeSeek;
  1456.     ULONG32 m_ulTimeAfterSeek;
  1459.     BufferingReason m_BufferingReason;
  1461.     CHXEventList m_EventList; // contains packets for all streams
  1463.     IHXScheduler* m_pScheduler;
  1465.     /* m_uNumSourcesActive gets decremented when we have sucked out all the packets
  1466.      * from the source 
  1467.      */
  1468.     UINT16 m_uNumSourcesActive : 16;
  1470.     /* m_uNumCurrentSourceNotDone gets decremented when a given source has received
  1471.      * all the packets from the server
  1472.      */
  1473.     UINT16 m_uNumCurrentSourceNotDone : 16;
  1475.     HX_BITFIELD m_bSourceMapUpdated : 1;
  1476.     HX_BITFIELD m_bInitialized : 1;
  1477.        
  1478.     // m_bIsDone: single presentation/individual group in a SMIL file
  1479.     // m_bIsPresentationDone: single/SMIL presentation
  1480.     HX_BITFIELD m_bIsDone : 1;
  1481.     HX_BITFIELD m_bIsPresentationDone : 1;
  1482.     HX_BITFIELD m_bInStop : 1;
  1483.     HX_BITFIELD m_bIsPresentationClosedToBeSent : 1;
  1484.     HX_BITFIELD m_bCloseAllRenderersPending : 1;
  1486.     HX_BITFIELD m_bUseCoreThread : 1;
  1487.     HX_BITFIELD m_bCoreLocked : 1;
  1488.     HX_BITFIELD m_bPaused : 1;
  1489.     HX_BITFIELD m_bBeginPending : 1;
  1491.     HX_BITFIELD m_bIsFirstBeginPending : 1;
  1493.     HX_BITFIELD m_bIsFirstBegin : 1;
  1495.     HX_BITFIELD m_bUserHasCalledBegin : 1;
  1497.     HX_BITFIELD m_bTimelineToBeResumed : 1;
  1498.     HX_BITFIELD m_bIsPlaying : 1;
  1500.     HX_BITFIELD m_bNetInitialized : 1;
  1501.     HX_BITFIELD m_bPrefTransportInitialized : 1;
  1503.     HX_BITFIELD m_bSetupLayoutSiteGroup : 1;
  1504.     
  1505.     HX_BITFIELD m_bTimeSyncLocked : 1;
  1507.     HX_BITFIELD m_bIsLive : 1;
  1508.     HX_BITFIELD m_bLiveSeekToBeDone : 1;
  1510.     HX_BITFIELD m_bProcessEventsLocked : 1;
  1511.     HX_BITFIELD m_bDidWeDeleteAllEvents : 1;
  1513.     ULONG32 m_ulLowestGranularity;
  1514.     UINT32 m_ulElapsedPauseTime;
  1515.     UINT32 m_ulLiveSeekTime;
  1516.     UINT32 m_ulTimeOfPause;
  1517.     UINT32 m_ulMinimumAudioPreroll;
  1518.     UINT32 m_ulMinimumTotalPreroll;
  1519.     
  1520.     friend class HXPlayerCallback;
  1522. //#if defined(HELIX_FEATURE_STATS) && defined(HELIX_FEATURE_REGISTRY)
  1523.     friend class UpdateStatsCallback;
  1524. //#endif /* HELIX_FEATURE_STATS && HELIX_FEATURE_REGISTRY */
  1526.     /* Used for multiple kive stream synchrnoization*/
  1527.     UINT32 m_ulFirstTimeSync;
  1529.     UINT32 m_ulFSBufferingEndTime;
  1530.     UINT16 m_uNumSourceToBeInitializedBeforeBegin : 16;
  1532.     HX_BITFIELD m_bFastStartInProgress : 1;
  1533.     HX_BITFIELD m_bIsFirstTimeSync : 1;
  1534.     HX_BITFIELD m_bPlayerWithoutSources : 1;
  1535.     HX_BITFIELD m_bInternalPauseResume : 1;
  1536.     HX_BITFIELD m_bInternalReset : 1;
  1537.     HX_BITFIELD m_bCurrentPresentationClosed : 1;
  1538.     HX_BITFIELD m_bContactingDone : 1;
  1539.     HX_BITFIELD m_bFSBufferingEnd : 1;
  1540.     HX_BITFIELD m_bAllLocalSources : 1;
  1541.     HX_BITFIELD m_b100BufferingToBeSent : 1;
  1542.     HX_BITFIELD m_bSetupToBeDone : 1;
  1543.     HX_BITFIELD m_bPostSetupToBeDone : 1;
  1544.     HX_BITFIELD m_bInternalReportError : 1;
  1545.     HX_BITFIELD m_bPartOfNextGroup : 1;   
  1546.     HX_BITFIELD m_bLastGroup : 1;
  1547.     HX_BITFIELD m_bNextGroupStarted : 1;
  1548.     HX_BITFIELD m_bBeginChangeLayoutTobeCalled : 1;
  1549.     HX_BITFIELD m_bPendingAudioPause : 1;
  1550.     HX_BITFIELD m_bPlayStateNotified : 1;
  1551.     HX_BITFIELD m_bResumeOnlyAtSystemTime : 1;
  1552.     HX_BITFIELD m_bSetModal : 1;
  1554. #if defined(HELIX_FEATURE_PREFETCH)
  1555.     PrefetchManager* m_pPrefetchManager;
  1556. #else
  1557.     void* m_pPrefetchManager;
  1558. #endif /* HELIX_FEATURE_PREFETCH */
  1560. #ifdef _WIN32
  1561.     BOOL m_bScreenSaverActive; 
  1562. #endif
  1564. #if defined(HELIX_FEATURE_NEXTGROUPMGR)
  1565.     NextGroupManager* m_pNextGroupManager;
  1566. #else
  1567.     void* m_pNextGroupManager;
  1568. #endif /* HELIX_FEATURE_NEXTGROUPMGR*/
  1570.     IHXGroup* m_pCurrentGroup;
  1572.     IHXPlayer* m_pParentPlayer;
  1573.     CHXSimpleList* m_pChildPlayerList;
  1575. #if defined(HELIX_FEATURE_ASM)
  1576.     IHXBandwidthManager* m_pBandwidthMgr;
  1577.     /* Only used for load testing */
  1578.     IHXBandwidthManager* m_pASM;
  1579. #endif /* HELIX_FEATURE_ASM */
  1581.     CHXSimpleList m_ToBeginRendererList;
  1582.     void EnterToBeginList(RendererInfo* pRendInfo);
  1583.     void EmptyBeginList(void) {m_ToBeginRendererList.RemoveAll();};
  1584.     HX_RESULT CheckBeginList(void);
  1585.     void RemoveFromPendingList(RendererInfo* pRendInfo);
  1587.     void CheckToStartNextGroup(void);
  1588.     void AdjustPresentationTime(void);
  1589.     void SetPresentationTime(UINT32 ulPresentationTime);
  1591.     void UpdateSourceActive(void);
  1592.     HX_RESULT UpdateSourceInfo(SourceInfo* pSourceInfo, 
  1593.  UINT32 ulParentRegId,
  1594.  UINT16 ulTrackIndex);
  1595.     HX_RESULT UpdatePersistentSrcInfo(SourceInfo* pSourceInfo, 
  1596.                                                 UINT32 ulParentRegId,
  1597.                                                 UINT16 ulTrackIndex);
  1599.     /*
  1600.      * The following members are related to the new layout support.
  1601.      */
  1602. #if defined(HELIX_FEATURE_VIDEO)
  1603.     CHXSiteManager* m_pSiteManager;
  1604.     IHXSiteSupplier* m_pSiteSupplier;
  1605. #else
  1606.     void* m_pSiteManager;
  1607.     void* m_pSiteSupplier;
  1608. #endif /* HELIX_FEATURE_VIDEO */
  1610.     CHXSimpleList m_SiteRequestIDList;
  1611.     
  1612.     void SetupRendererSite(IUnknown* pRenderer, IHXValues* pProps, BOOL bIsPersistent);
  1613.     void SetupLayoutSiteGroup(IUnknown* pLSG, BOOL bIsPersistent);
  1614.     STDMETHODIMP SetupLayout(BOOL bIsPersistent);
  1615.     STDMETHODIMP CleanupLayout(void);
  1617.     HX_RESULT StartDownload(void);
  1618.     HX_RESULT PauseDownload(void);
  1619.     void UnregisterNonActiveSources();
  1620.     BOOL AreAllSourcesSeekable(void);
  1621.     void ResetError(void);
  1622.     void ResetRedirectList(void);
  1623.     void SetLastError(HX_RESULT theErr);
  1625.     void Close();
  1626.     void AbortPlayer(void);
  1627.     void StopPlayer(EndCode endCode = END_STOP);
  1628.     HX_RESULT PausePlayer(BOOL bNotifyTLC = TRUE);
  1629.     HX_RESULT SeekPlayer(ULONG32 ulTime);
  1630.     HX_RESULT BeginPlayer(void);
  1632.     HX_RESULT SetupAudioPlayer(void);
  1633.     virtual HX_RESULT PrepareAudioPlayer(void);
  1635. //#if defined(HELIX_FEATURE_AUTHENTICATION)
  1636.     void ProcessPendingAuthentication();
  1637.     void ClearPendingAuthenticationRequests();
  1638. //#endif /* HELIX_FEATURE_AUTHENTICATION */
  1640.     void SendPostSeekIfNecessary(RendererInfo* pRendererInfo);
  1642.     BOOL ScheduleOnTimeSync(void);
  1643.     BOOL DurationTimeSyncAllSent(SourceInfo* pSourceInfo);
  1644.     virtual void DisableScreenSaver();
  1645.     void                RemovePendingCallback(CHXGenericCallback* pCB);
  1647. #if defined(HELIX_FEATURE_AUTOUPGRADE)
  1648.     IHXUpgradeCollection* m_pUpgradeCollection;
  1649. #else
  1650.     void* m_pUpgradeCollection;
  1651. #endif /* HELIX_FEATURE_AUTOUPGRADE */
  1653.     friend class NextGroupManager;
  1655. //#if defined(HELIX_FEATURE_PREFETCH)
  1656.     friend class PrefetchManager;
  1657. //#endif /* HELIX_FEATURE_PREFETCH */
  1658.     
  1659.     // used to notify of changes to the precache group
  1660. #if defined(HELIX_FEATURE_ADVANCEDGROUPMGR)
  1661.     friend class HXAdvancedGroup;    
  1662.     friend class HXAdvancedGroupManager;    
  1663. #endif /* HELIX_FEATURE_ADVANCEDGROUPMGR */
  1665. #if defined(HELIX_FEATURE_BASICGROUPMGR)
  1666.     friend class HXBasicGroup;
  1667.     friend class HXBasicGroupManager;
  1668. #endif /* HELIX_FEATURE_BASICGROUPMGR */
  1670.     HX_RESULT NextGroupSet(UINT16 uGroupIndex);
  1672. //#if defined(HELIX_FEATURE_AUTHENTICATION)
  1673. #ifndef _WIN16
  1674.     // Store pending requests
  1675.     friend class _CHXAuthenticationRequests;
  1676.     _CHXAuthenticationRequests m_AuthenticationRequestsPending;
  1677. #endif /* _WIN16 */
  1678. //#endif /* HELIX_FEATURE_AUTHENTICATION */
  1680.     HXMutex* m_pCoreMutex;
  1682.     /*
  1683.      * -- LIVE SYNC SUPPORT --
  1684.      *
  1685.      * The following is related to shared wall clock support
  1686.      * for syncronizing several live sources. See srcinfo.cpp
  1687.      * for more informantion.
  1688.      */
  1689. private:
  1690.     CHXMapStringToOb* m_pSharedWallClocks;
  1691.     friend class SharedWallClock;
  1693.     IHXRecordService* m_pRecordService;
  1694.     BOOL                m_bRecordServiceEnabled;
  1696. public:
  1697.     BOOL FindSharedWallClocks(const char* pClockName, void*& ppValue)
  1698.     {
  1699. return m_pSharedWallClocks->Lookup(pClockName,ppValue);
  1700.     };
  1701. };
  1703. #if defined(HELIX_FEATURE_STATS) && defined(HELIX_FEATURE_REGISTRY)
  1704. class UpdateStatsCallback : public IHXCallback
  1705. {
  1706. public:
  1707.     HXPlayer* m_pPlayer;
  1708.     CallbackHandle m_PendingHandle;
  1709.     BOOL m_bIsCallbackPending;
  1711. UpdateStatsCallback();
  1712.     /*
  1713.      * IUnknown methods
  1714.      */
  1715.     STDMETHOD(QueryInterface) (THIS_
  1716.     REFIID riid,
  1717.     void** ppvObj);
  1719.     STDMETHOD_(ULONG32,AddRef) (THIS);
  1721.     STDMETHOD_(ULONG32,Release) (THIS);
  1723.     /*
  1724.      * IHXCallback methods
  1725.      */
  1726.     STDMETHOD(Func) (THIS);
  1728. protected:
  1729. ~UpdateStatsCallback();
  1731.     LONG32 m_lRefCount;
  1732. };
  1733. #endif /* HELIX_FEATURE_STATS && HELIX_FEATURE_REGISTRY */
  1735. #if defined (_WIN32) || defined (_MACINTOSH) || defined(THREADS_SUPPORTED)
  1736. class HXPlayerCallback : public CHXGenericCallback
  1737.                        , public IHXInterruptSafe
  1738. {
  1739. public:    
  1740.     BOOL m_bInterrupSafe;
  1742.     HXPlayerCallback(void* pParam, fGenericCBFunc pFunc);
  1743.     
  1744.     STDMETHOD_(ULONG32,AddRef) (THIS) {return CHXGenericCallback::AddRef();}
  1745.     STDMETHOD_(ULONG32,Release) (THIS) {return CHXGenericCallback::Release();}
  1746.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void** ppvObj);
  1748.     STDMETHOD_(BOOL,IsInterruptSafe) (THIS);
  1750. protected:
  1751.     ~HXPlayerCallback() {};
  1752. };
  1753. #endif //(_WIN32) || defined (_MACINTOSH) || defined(THREADS_SUPPORTED)
  1755. #endif //_HXPLAYER_