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

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

Symbian

开发平台：

Visual C++

hxcore.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxcore.h,v 1.3.22.3 2004/07/09 01:45:08 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 _HXCORE_H_
  51. #define _HXCORE_H_
  53. /*
  54.  * Forward declarations of some interfaces defined or used here-in.
  55.  */
  56. typedef _INTERFACE IUnknown IUnknown;
  57. typedef _INTERFACE IHXStream IHXStream;
  58. typedef _INTERFACE IHXStreamSource IHXStreamSource;
  59. typedef _INTERFACE IHXPlayer IHXPlayer;
  60. typedef _INTERFACE IHXClientEngine IHXClientEngine;
  61. typedef _INTERFACE IHXScheduler IHXScheduler;
  62. typedef _INTERFACE IHXClientAdviseSink IHXClientAdviseSink;
  63. typedef _INTERFACE IHXValues       IHXValues;
  64. typedef _INTERFACE IHXBuffer       IHXBuffer;
  65. typedef _INTERFACE IHXPacket IHXPacket;
  66. // $Private:
  67. typedef _INTERFACE IHXPersistenceManager IHXPersistenceManager;
  68. typedef _INTERFACE IHXRendererAdviseSink IHXRendererAdviseSink;
  69. typedef _INTERFACE IHXLayoutSite IHXLayoutSite;
  70. typedef _INTERFACE IHXProtocolValidator IHXProtocolValidator;
  71. typedef _INTERFACE IHXUpdateProperties IHXUpdateProperties;
  72. typedef _INTERFACE IHXPersistentComponentManager IHXPersistentComponentManager;
  73. typedef _INTERFACE IHXPersistentComponent IHXPersistentComponent;
  74. typedef _INTERFACE IHXPersistentRenderer IHXPersistentRenderer;
  75. typedef _INTERFACE IHXCoreMutex IHXCoreMutex;
  76. typedef _INTERFACE IHXMacBlitMutex IHXMacBlitMutex;
  77. // $EndPrivate.
  78. typedef _INTERFACE IHXRenderer IHXRenderer;
  79. typedef _INTERFACE IHXPlayer2 IHXPlayer2;
  80. typedef _INTERFACE IHXRequest IHXrequest;
  81. typedef _INTERFACE IHXPlayerNavigator IHXPlayerNavigator;
  82. typedef _INTERFACE IHXGroupSink IHXGroupSink;
  84. typedef struct _PersistentComponentInfo PersistentComponentInfo;
  85. typedef struct _HXxEvent HXxEvent;
  88. #ifdef _MAC_CFM
  89. #pragma export on
  90. #endif
  92. #if defined _UNIX && !(defined _VXWORKS)
  93. /* Includes needed for select() stuff */
  94. #include <sys/time.h>
  95. #include <sys/types.h>
  96. #include <unistd.h>
  97. #endif
  99. #ifdef _BEOS // fd_set stuff
  100. #include <net/socket.h>
  101. #endif
  103. #include "hxwin.h"
  105. /* Used in renderer and advise sink interface */
  106. enum BUFFERING_REASON
  107. {
  108.     BUFFERING_START_UP = 0,
  109.     BUFFERING_SEEK,
  110.     BUFFERING_CONGESTION,
  111.     BUFFERING_LIVE_PAUSE
  112. };
  114. /****************************************************************************
  115.  * 
  116.  *  Function:
  117.  * 
  118.  * CreateEngine()
  119.  * 
  120.  *  Purpose:
  121.  * 
  122.  * Function implemented by the RMA core to return a pointer to the
  123.  * client engine.  This function would be run by top level clients.
  124.  */
  125. STDAPI CreateEngine
  126. (
  127.     IHXClientEngine**  /*OUT*/ ppEngine
  128. );
  130. /****************************************************************************
  131.  * 
  132.  *  Function:
  133.  * 
  134.  * CloseEngine()
  135.  * 
  136.  *  Purpose:
  137.  * 
  138.  * Function implemented by the RMA core to close the engine which
  139.  * was returned in CreateEngine().
  140.  */
  141. STDAPI CloseEngine
  142. (
  143.     IHXClientEngine*  /*IN*/ pEngine
  144. );
  146. #ifdef _MAC_CFM
  147. #pragma export off
  148. #endif
  150. /*
  151.  * Definitions of Function Pointers to CreateEngine() and Close Engine().
  152.  * These types are provided as a convenince to authors of top level clients.
  153.  */
  154. typedef HX_RESULT (HXEXPORT_PTR FPRMCREATEENGINE)(IHXClientEngine** ppEngine);
  155. typedef HX_RESULT (HXEXPORT_PTR FPRMCLOSEENGINE) (IHXClientEngine*  pEngine);
  158. /****************************************************************************
  159.  * 
  160.  *  Interface:
  161.  *
  162.  * IHXStream
  163.  *
  164.  *  Purpose:
  165.  *
  166.  * Interface provided by the client engine to the renderers. This
  167.  * interface allows access to stream related information and properties.
  168.  *
  169.  *  IID_IHXStream:
  170.  *
  171.  * {00000400-0901-11d1-8B06-00A024406D59}
  172.  *
  173.  */
  174. DEFINE_GUID(IID_IHXStream, 0x00000400, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  175. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  177. #undef  INTERFACE
  178. #define INTERFACE   IHXStream
  180. DECLARE_INTERFACE_(IHXStream, IUnknown)
  181. {
  182.     /*
  183.      * IUnknown methods
  184.      */
  185.     STDMETHOD(QueryInterface) (THIS_
  186. REFIID riid,
  187. void** ppvObj) PURE;
  189.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  191.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  193.     /*
  194.      * IHXStream methods
  195.      */
  197.     /************************************************************************
  198.      * Method:
  199.      *     IHXStream::GetSource
  200.      * Purpose:
  201.      *     Get the interface to the source object of which the stream is
  202.      *     a part of.
  203.      *
  204.      */
  205.     STDMETHOD(GetSource) (THIS_
  206. REF(IHXStreamSource*) pSource) PURE;
  208.     /************************************************************************
  209.      * Method:
  210.      *     IHXStream::GetStreamNumber
  211.      * Purpose:
  212.      *     Get the stream number for this stream relative to the source 
  213.      *     object of which the stream is a part of.
  214.      *
  215.      */
  216.     STDMETHOD_(UINT16,GetStreamNumber)     (THIS) PURE;
  218.     /************************************************************************
  219.      * Method:
  220.      *     IHXStream::GetStreamType
  221.      * Purpose:
  222.      *     Get the MIME type for this stream. NOTE: The returned string is
  223.      *     assumed to be valid for the life of the IHXStream from which it
  224.      *     was returned.
  225.      *
  226.      */
  227.     STDMETHOD_(const char*,GetStreamType)   (THIS) PURE;
  229.     /************************************************************************
  230.      * Method:
  231.      *     IHXStream::GetHeader
  232.      * Purpose:
  233.      *      Get the header for this stream.
  234.      *
  235.      */
  236.     STDMETHOD_(IHXValues*,GetHeader)   (THIS) PURE;
  238.     /************************************************************************
  239.      * Method:
  240.      *     IHXStream::ReportQualityOfService
  241.      * Purpose:
  242.      *     Call this method to report to the playback context that the 
  243.      *     quality of service for this stream has changed. The unQuality
  244.      *     should be on a scale of 0 to 100, where 100 is the best possible
  245.      *     quality for this stream. Although the transport engine can 
  246.      *     determine lost packets and report these through the user
  247.      *     interface, only the renderer of this stream can determine the 
  248.      *     "real" perceived damage associated with this loss.
  249.      *
  250.      *     NOTE: The playback context may use this value to indicate loss
  251.      *     in quality to the user interface. When the effects of a lost
  252.      *     packet are eliminated the renderer should call this method with
  253.      *     a unQuality of 100.
  254.      *
  255.      */
  256.     STDMETHOD(ReportQualityOfService)     (THIS_
  257.     UINT8   unQuality) PURE;
  259.     /************************************************************************
  260.      * Method:
  261.      *     IHXStream::ReportRebufferStatus
  262.      * Purpose:
  263.      *     Call this method to report to the playback context that the
  264.      *     available data has dropped to a critically low level, and that
  265.      *     rebuffering should occur. The renderer should call back into this
  266.      *     interface as it receives additional data packets to indicate the
  267.      *     status of its rebuffering effort.
  268.      *
  269.      *     NOTE: The values of unNeeded and unAvailable are used to indicate
  270.      *     the general status of the rebuffering effort. For example, if a
  271.      *     renderer has "run dry" and needs 5 data packets to play smoothly
  272.      *     again, it should call ReportRebufferStatus() with 5,0 then as
  273.      *     packet arrive it should call again with 5,1; 5,2... and eventually
  274.      *     5,5.
  275.      *
  276.      */
  277.     STDMETHOD(ReportRebufferStatus)     (THIS_
  278.     UINT8   unNeeded,
  279.     UINT8   unAvailable) PURE;
  281.     /************************************************************************
  282.      * Method:
  283.      *     IHXStream::SetGranularity
  284.      * Purpose:
  285.      *     Sets the desired Granularity for this stream. The actual 
  286.      *     granularity will be the lowest granularity of all streams.
  287.      *     Valid to call before stream actually begins. Best to call during
  288.      *     IHXRenderer::OnHeader().
  289.      */
  290.     STDMETHOD(SetGranularity)     (THIS_
  291.     ULONG32 ulGranularity) PURE;
  293.     /************************************************************************
  294.      * Method:
  295.      *     IHXStream::GetRendererCount
  296.      * Purpose:
  297.      *     Returns the current number of renderer instances supported by
  298.      *     this stream instance.
  299.      */
  300.     STDMETHOD_(UINT16, GetRendererCount)(THIS) PURE;
  302.     /************************************************************************
  303.      * Method:
  304.      *     IHXStream::GetRenderer
  305.      * Purpose:
  306.      *     Returns the Nth renderer instance supported by this stream.
  307.      */
  308.     STDMETHOD(GetRenderer) (THIS_
  309. UINT16 nIndex,
  310. REF(IUnknown*) pUnknown) PURE;
  311. };
  314. /****************************************************************************
  315.  * 
  316.  *  Interface:
  317.  *
  318.  * IHXStreamSource
  319.  *
  320.  *  Purpose:
  321.  *
  322.  * Interface provided by the client engine to the renderers. This
  323.  * interface allows access to source related information and properties.
  324.  *
  325.  *  IID_IHXStreamSource:
  326.  *
  327.  * {00000401-0901-11d1-8B06-00A024406D59}
  328.  *
  329.  */
  330. DEFINE_GUID(IID_IHXStreamSource, 0x00000401, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  331. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  333. #undef  INTERFACE
  334. #define INTERFACE   IHXStreamSource
  336. DECLARE_INTERFACE_(IHXStreamSource, IUnknown)
  337. {
  338.     /*
  339.      * IUnknown methods
  340.      */
  341.     STDMETHOD(QueryInterface) (THIS_
  342. REFIID riid,
  343. void** ppvObj) PURE;
  345.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  347.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  349.     /*
  350.      * IHXStreamSource methods
  351.      */
  353.     /************************************************************************
  354.      * Method:
  355.      * IHXStreamSource::IsLive
  356.      * Purpose:
  357.      * Ask the source whether it is live
  358.      *
  359.      */
  360.     STDMETHOD_ (BOOL,IsLive) (THIS) PURE;
  362.     /************************************************************************
  363.      * Method:
  364.      *     IHXStreamSource::GetPlayer
  365.      * Purpose:
  366.      *     Get the interface to the player object of which the source is
  367.      *     a part of.
  368.      *
  369.      */
  370.     STDMETHOD(GetPlayer)     (THIS_
  371.     REF(IHXPlayer*) pPlayer) PURE;
  373.     /************************************************************************
  374.      * Method:
  375.      *     IHXStreamSource::GetURL
  376.      * Purpose:
  377.      *     Get the URL for this source. NOTE: The returned string is
  378.      *     assumed to be valid for the life of the IHXStreamSource from which
  379.      *     it was returned.
  380.      *
  381.      */
  382.     STDMETHOD_(const char*,GetURL)  (THIS) PURE;
  384.     /************************************************************************
  385.      * Method:
  386.      *     IHXStreamSource::GetStreamCount
  387.      * Purpose:
  388.      *     Returns the current number of stream instances supported by
  389.      *     this source instance.
  390.      */
  391.     STDMETHOD_(UINT16, GetStreamCount)(THIS) PURE;
  393.     /************************************************************************
  394.      * Method:
  395.      *     IHXStreamSource::GetStream
  396.      * Purpose:
  397.      *     Returns the Nth stream instance supported by this source.
  398.      */
  399.     STDMETHOD(GetStream) (THIS_
  400. UINT16 nIndex,
  401. REF(IUnknown*) pUnknown) PURE;
  402. };
  405. /****************************************************************************
  406.  * 
  407.  *  Interface:
  408.  *
  409.  *   IHXPlayer
  410.  *
  411.  *  Purpose:
  412.  *
  413.  * Interface provided by the client engine to the renderers. This
  414.  * interface allows access to player related information, properties,
  415.  * and operations.
  416.  *
  417.  *  IID_IHXPlayer:
  418.  *
  419.  * {00000402-0901-11d1-8B06-00A024406D59}
  420.  *
  421.  */
  422. DEFINE_GUID(IID_IHXPlayer, 0x00000402, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  423. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  425. #undef  INTERFACE
  426. #define INTERFACE   IHXPlayer
  428. DECLARE_INTERFACE_(IHXPlayer, IUnknown)
  429. {
  430.     /*
  431.      * IUnknown methods
  432.      */
  433.     STDMETHOD(QueryInterface) (THIS_
  434. REFIID riid,
  435. void** ppvObj) PURE;
  437.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  439.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  441.     /*
  442.      * IHXPlayer methods
  443.      */
  445.     /************************************************************************
  446.      * Method:
  447.      * IHXPlayer::GetClientEngine
  448.      * Purpose:
  449.      * Get the interface to the client engine object of which the
  450.      * player is a part of.
  451.      *
  452.      */
  453.     STDMETHOD(GetClientEngine) (THIS_
  454. REF(IHXClientEngine*) pEngine) PURE;
  456.     /************************************************************************
  457.      * Method:
  458.      * IHXPlayer::IsDone
  459.      * Purpose:
  460.      * Ask the player if it is done with the current presentation
  461.      *
  462.      */
  463.     STDMETHOD_(BOOL,IsDone) (THIS) PURE;
  465.     /************************************************************************
  466.      * Method:
  467.      * IHXPlayer::IsLive
  468.      * Purpose:
  469.      * Ask the player whether it contains the live source
  470.      *
  471.      */
  472.     STDMETHOD_(BOOL,IsLive) (THIS) PURE;
  474.     /************************************************************************
  475.      * Method:
  476.      * IHXPlayer::GetCurrentPlayTime
  477.      * Purpose:
  478.      * Get the current time on the Player timeline
  479.      *
  480.      */
  481.     STDMETHOD_(ULONG32,GetCurrentPlayTime) (THIS) PURE;
  483.     /************************************************************************
  484.      * Method:
  485.      * IHXPlayer::OpenURL
  486.      * Purpose:
  487.      * Tell the player to begin playback of all its sources.
  488.      *
  489.      */
  490.     STDMETHOD(OpenURL) (THIS_
  491.     const char* pURL) PURE;
  493.     /************************************************************************
  494.      * Method:
  495.      * IHXPlayer::Begin
  496.      * Purpose:
  497.      * Tell the player to begin playback of all its sources.
  498.      *
  499.      */
  500.     STDMETHOD(Begin) (THIS) PURE;
  502.     /************************************************************************
  503.      * Method:
  504.      * IHXPlayer::Stop
  505.      * Purpose:
  506.      * Tell the player to stop playback of all its sources.
  507.      *
  508.      */
  509.     STDMETHOD(Stop) (THIS) PURE;
  511.     /************************************************************************
  512.      * Method:
  513.      * IHXPlayer::Pause
  514.      * Purpose:
  515.      * Tell the player to pause playback of all its sources.
  516.      *
  517.      */
  518.     STDMETHOD(Pause) (THIS) PURE;
  520.     /************************************************************************
  521.      * Method:
  522.      * IHXPlayer::Seek
  523.      * Purpose:
  524.      * Tell the player to seek in the playback timeline of all its 
  525.      * sources.
  526.      *
  527.      */
  528.     STDMETHOD(Seek) (THIS_
  529. ULONG32 ulTime) PURE;
  531.     /************************************************************************
  532.      * Method:
  533.      *     IHXPlayer::GetSourceCount
  534.      * Purpose:
  535.      *     Returns the current number of source instances supported by
  536.      *     this player instance.
  537.      */
  538.     STDMETHOD_(UINT16, GetSourceCount)(THIS) PURE;
  540.     /************************************************************************
  541.      * Method:
  542.      *     IHXPlayer::GetSource
  543.      * Purpose:
  544.      *     Returns the Nth source instance supported by this player.
  545.      */
  546.     STDMETHOD(GetSource) (THIS_
  547. UINT16 nIndex,
  548. REF(IUnknown*) pUnknown) PURE;
  550.     /************************************************************************
  551.      * Method:
  552.      *     IHXPlayer::SetClientContext
  553.      * Purpose:
  554.      *     Called by the client to install itself as the provider of client
  555.      *     services to the core. This is traditionally called by the top 
  556.      *     level client application.
  557.      */
  558.     STDMETHOD(SetClientContext) (THIS_
  559. IUnknown* pUnknown) PURE;
  561.     /************************************************************************
  562.      * Method:
  563.      *     IHXPlayer::GetClientContext
  564.      * Purpose:
  565.      *     Called to get the client context for this player. This is
  566.      *     set by the top level client application.
  567.      */
  568.     STDMETHOD(GetClientContext) (THIS_
  569. REF(IUnknown*) pUnknown) PURE;
  571.     /************************************************************************
  572.      * Method:
  573.      *     IHXPlayer::AddAdviseSink
  574.      * Purpose:
  575.      *     Call this method to add a client advise sink.
  576.      *
  577.      */
  578.     STDMETHOD(AddAdviseSink) (THIS_
  579. IHXClientAdviseSink* pAdviseSink) PURE;
  581.     /************************************************************************
  582.      * Method:
  583.      *     IHXPlayer::RemoveAdviseSink
  584.      * Purpose:
  585.      *     Call this method to remove a client advise sink.
  586.      */
  587.     STDMETHOD(RemoveAdviseSink) (THIS_
  588. IHXClientAdviseSink* pAdviseSink) PURE;
  589. };
  592. /****************************************************************************
  593.  * 
  594.  *  Interface:
  595.  *
  596.  * IHXClientEngine
  597.  *
  598.  *  Purpose:
  599.  *
  600.  * Interface to the basic client engine. Provided to the renderers and
  601.  * other client side components.
  602.  *
  603.  *  IID_IHXClientEngine:
  604.  *
  605.  * {00000403-0901-11d1-8B06-00A024406D59}
  606.  */
  607. DEFINE_GUID(IID_IHXClientEngine, 0x00000403, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  608. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  610. #undef  INTERFACE
  611. #define INTERFACE   IHXClientEngine
  613. DECLARE_INTERFACE_(IHXClientEngine, IUnknown)
  614. {
  615.     /*
  616.      * IUnknown methods
  617.      */
  618.     STDMETHOD(QueryInterface) (THIS_
  619. REFIID riid,
  620. void** ppvObj) PURE;
  622.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  624.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  626.     /*
  627.      * IHXClientEngine methods
  628.      */
  630.     /************************************************************************
  631.      * Method:
  632.      *     IHXClientEngine::CreatePlayer
  633.      * Purpose:
  634.      *     Creates a new IHXPlayer instance.
  635.      *
  636.      */
  637.     STDMETHOD(CreatePlayer) (THIS_
  638. REF(IHXPlayer*)    pPlayer) PURE;
  640.     /************************************************************************
  641.      * Method:
  642.      *     IHXClientEngine::ClosePlayer
  643.      * Purpose:
  644.      *     Called by the client when it is done using the player...
  645.      *
  646.      */
  647.     STDMETHOD(ClosePlayer) (THIS_
  648. IHXPlayer*    pPlayer) PURE;
  650.     /************************************************************************
  651.      * Method:
  652.      *     IHXClientEngine::GetPlayerCount
  653.      * Purpose:
  654.      *     Returns the current number of IHXPlayer instances supported by
  655.      *     this client engine instance.
  656.      */
  657.     STDMETHOD_(UINT16, GetPlayerCount)(THIS) PURE;
  659.     /************************************************************************
  660.      * Method:
  661.      *     IHXClientEngine::GetPlayer
  662.      * Purpose:
  663.      *     Returns the Nth IHXPlayer instances supported by this client 
  664.      *     engine instance.
  665.      */
  666.     STDMETHOD(GetPlayer) (THIS_
  667. UINT16 nPlayerNumber,
  668. REF(IUnknown*) pUnknown) PURE;
  670.     /************************************************************************
  671.      * Method:
  672.      *     IHXClientEngine::EventOccurred
  673.      * Purpose:
  674.      *     Clients call this to pass OS events to all players. HXxEvent
  675.      *     defines a cross-platform event.
  676.      */
  677.     STDMETHOD(EventOccurred) (THIS_
  678. HXxEvent* /*IN*/ pEvent) PURE;
  680. };
  682. // $Private:
  683. /****************************************************************************
  684.  * 
  685.  *  Interface:
  686.  *
  687.  * IHXClientEngineMapper
  688.  *
  689.  *  Purpose:
  690.  *
  691.  * Interface to the basic client engine. Provided to the renderers and
  692.  * other client side components.
  693.  *
  694.  *  IID_IHXClientEngineMapper:
  695.  *
  696.  * {0000040A-0901-11d1-8B06-00A024406D59}
  697.  */
  698. DEFINE_GUID(IID_IHXClientEngineMapper, 0x0000040A, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  699. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  701. #undef  INTERFACE
  702. #define INTERFACE   IHXClientEngineMapper
  704. DECLARE_INTERFACE_(IHXClientEngineMapper, IUnknown)
  705. {
  706.     /*
  707.      * IUnknown methods
  708.      */
  709.     STDMETHOD(QueryInterface) (THIS_
  710. REFIID riid,
  711. void** ppvObj) PURE;
  713.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  715.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  717.     /*
  718.      * IHXClientEngineMapper methods
  719.      */
  721.     /************************************************************************
  722.      * Method:
  723.      *     IHXClientEngineMapper::GetPlayerBySite
  724.      * Purpose:
  725.      *     Returns the IHXPlayer instance supported by this client 
  726.      *     engine instance that contains the specified IHXSite.
  727.      */
  728.     STDMETHOD(GetPlayerBySite) (THIS_
  729. IHXSite* pSite,
  730. REF(IUnknown*) pUnknown) PURE;
  731. };
  732. // $EndPrivate:
  734. #if defined _UNIX && !defined (_VXWORKS)
  735. DEFINE_GUID(IID_IHXClientEngineSelector, 0x00000404, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  736. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  738. #undef  INTERFACE
  739. #define INTERFACE   IHXClientEngineSelector
  741. DECLARE_INTERFACE_(IHXClientEngineSelector, IUnknown)
  742. {
  743.     /*
  744.      * IUnknown methods
  745.      */
  746.     STDMETHOD(QueryInterface) (THIS_
  747. REFIID riid,
  748. void** ppvObj) PURE;
  750.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  752.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  754.     /************************************************************************
  755.      * Method:
  756.      *     IHXClientEngine::Select
  757.      * Purpose:
  758.      *      Top level clients under Unix should use this instead of
  759.      *      select() to select for events.
  760.      */
  761.     STDMETHOD_(INT32, Select) (THIS_
  762.        INT32 n,
  763.        fd_set *readfds,
  764.        fd_set *writefds,
  765.        fd_set *exceptfds,
  766.        struct timeval* timeout) PURE;
  767. };
  768. #endif /* _UNIX */
  770. /****************************************************************************
  771.  * 
  772.  *  Interface:
  773.  *
  774.  * IHXClientEngineSetup
  775.  *
  776.  *  Purpose:
  777.  *
  778.  * Interface to the basic client engine. Provided to the renderers and
  779.  * other client side components.
  780.  *
  781.  *  IID_IHXClientEngineSetup:
  782.  *
  783.  * {00000405-0901-11d1-8B06-00A024406D59}
  784.  */
  785. DEFINE_GUID(IID_IHXClientEngineSetup, 0x00000405, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  786. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  788. #undef  INTERFACE
  789. #define INTERFACE   IHXClientEngineSetup
  791. DECLARE_INTERFACE_(IHXClientEngineSetup, IUnknown)
  792. {
  793.     /*
  794.      * IUnknown methods
  795.      */
  796.     STDMETHOD(QueryInterface) (THIS_
  797. REFIID riid,
  798. void** ppvObj) PURE;
  800.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  802.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  804.     /*
  805.      * IHXClientEngineSetup methods
  806.      */
  808.     /************************************************************************
  809.      * Method:
  810.      *     IHXClientEngineSetup::Setup
  811.      * Purpose:
  812.      *      Top level clients use this interface to over-ride certain basic 
  813.      *     interfaces implemented by the core. Current over-ridable 
  814.      *     interfaces are: IHXPreferences, IHXHyperNavigate
  815.      */
  816.     STDMETHOD(Setup) (THIS_
  817. IUnknown* pContext) PURE;
  818. };
  821. /****************************************************************************
  822.  * 
  823.  *  Interface:
  824.  *
  825.  * IHXInfoLogger
  826.  *
  827.  *  Purpose:
  828.  *
  829.  * Interface to send any logging information back to the server.
  830.  * This information will appear in the server's access log.
  831.  *
  832.  *  IID_IHXInfoLogger:
  833.  *
  834.  * {00000409-0901-11d1-8B06-00A024406D59}
  835.  */
  836. DEFINE_GUID(IID_IHXInfoLogger, 0x00000409, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  837. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  839. #undef  INTERFACE
  840. #define INTERFACE   IHXInfoLogger
  842. DECLARE_INTERFACE_(IHXInfoLogger, IUnknown)
  843. {
  844.     /*
  845.      * IUnknown methods
  846.      */
  847.     STDMETHOD(QueryInterface) (THIS_
  848. REFIID riid,
  849. void** ppvObj) PURE;
  851.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  853.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  855.     /*
  856.      * IHXInfoLogger methods
  857.      */
  859.     /************************************************************************
  860.      * Method:
  861.      *     IHXInfoLogger::LogInformation
  862.      * Purpose:
  863.      *     Logs any user defined information in form of action and 
  864.      *     associated data.
  865.      */
  866.     STDMETHOD(LogInformation) (THIS_
  867. const char* /*IN*/ pAction,
  868. const char* /*IN*/ pData) PURE;
  869. };
  872. // $Private:
  873. /****************************************************************************
  874.  * 
  875.  *  Interface:
  876.  *
  877.  * IHXPersistenceManager
  878.  *
  879.  *  Purpose:
  880.  *
  881.  *
  882.  *  IID_IHXPersistenceManager:
  883.  *
  884.  * {0000040B-0901-11d1-8B06-00A024406D59}
  885.  */
  886. DEFINE_GUID(IID_IHXPersistenceManager, 0x0000040B, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  887. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  889. #undef  INTERFACE
  890. #define INTERFACE   IHXPersistenceManager
  892. DECLARE_INTERFACE_(IHXPersistenceManager, IUnknown)
  893. {
  894.    /*
  895.     *  IUnknown methods
  896.     */
  897.    STDMETHOD(QueryInterface)       (THIS_
  898.                    REFIID riid,
  899.                    void** ppvObj) PURE;
  901.    STDMETHOD_(ULONG32,AddRef)      (THIS) PURE;
  903.    STDMETHOD_(ULONG32,Release)     (THIS) PURE;
  905.    /*
  906.     *  IHXPersistenceManager methods
  907.     */
  908.    /************************************************************************
  909.    *  Method:
  910.    *      IHXPersistenceManager::AddPersistentComponent
  911.    *  Purpose:
  912.    *    We currently allow ONLY IHXRenderer to register itself as a 
  913.    *    persistent component.
  914.    *       Renderer registers itself as a persistent renderer if it wants
  915.    *       to live across group boundaries.
  916.    *       It will not be unloaded until
  917.    *           a) Someone opens the next URL.
  918.    *           b) All the groups within the current presentation have been 
  919.    *              played.
  920.    */
  921.    STDMETHOD(AddPersistentComponent)    (THIS_
  922.                                        IUnknown*  /*IN*/ pComponent) PURE;
  924.    /************************************************************************
  925.    *  Method:
  926.    *      IHXPersistenceManager::RemovePersistentComponent
  927.    *  Purpose:
  928.    *       Remove an earlier registered persistent component.
  929.    */
  930.    STDMETHOD(RemovePersistentComponent) (THIS_
  931.                                        IUnknown*  /*IN*/ pComponent) PURE;
  933.    /************************************************************************
  934.    *  Method:
  935.    *      IHXPersistenceManager::GetPersistentComponent
  936.    *  Purpose:
  937.    *       Return an earlier registered persistent component.
  938.    */
  939.    STDMETHOD(GetPersistentComponent) (THIS_
  940.                                      REF(IUnknown*)  /*OUT*/ pComponent) PURE;
  942. };
  944. /****************************************************************************
  945.  * 
  946.  *  Interface:
  947.  *
  948.  * IHXDriverStreamManager
  949.  *
  950.  *  Purpose:
  951.  * Methods to notify/update driver stream renderer
  952.  *
  953.  *
  954.  *  IID_IHXDriverStreamManager
  955.  *
  956.  * {0000040C-0901-11d1-8B06-00A024406D59}
  957.  */
  958. DEFINE_GUID(IID_IHXDriverStreamManager, 0x0000040C, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  959. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  961. #undef  INTERFACE
  962. #define INTERFACE   IHXDriverStreamManager
  964. DECLARE_INTERFACE_(IHXDriverStreamManager, IUnknown)
  965. {
  966.    /*
  967.     *  IUnknown methods
  968.     */
  969.    STDMETHOD(QueryInterface)       (THIS_
  970.                    REFIID riid,
  971.                    void** ppvObj) PURE;
  973.    STDMETHOD_(ULONG32,AddRef)      (THIS) PURE;
  975.    STDMETHOD_(ULONG32,Release)     (THIS) PURE;
  977.    /*
  978.     *  IHXDriverStreamManager methods
  979.     */
  980.    /************************************************************************
  981.    *  Method:
  982.    *      IHXDriverStreamManager::AddRendererAdviseSink
  983.    *  Purpose:
  984.    *   Add a renderer advise sink 
  985.    * 
  986.    */
  987.    STDMETHOD(AddRendererAdviseSink)      (THIS_
  988.                                    IHXRendererAdviseSink* pSink) PURE;
  990.    /************************************************************************
  991.    *  Method:
  992.    *      IHXDriverStreamManager::SetDriverStreamManager
  993.    *  Purpose:
  994.    *   Remove an advise sink
  995.    * 
  996.    */
  997.    STDMETHOD(RemoveRendererAdviseSink)   (THIS_
  998.                                    IHXRendererAdviseSink* pSink) PURE;
  999. };
  1002. /****************************************************************************
  1003.  * 
  1004.  *  Interface:
  1005.  * IHXRendererAdviseSink
  1006.  *
  1007.  *  Purpose:
  1008.  * Provides access to notifications of initialization/changes to
  1009.  * renderers in the player.
  1010.  *
  1011.  *  IID_IHXRendererAdviseSink
  1012.  *
  1013.  * {0000040D-0901-11d1-8B06-00A024406D59}
  1014.  *
  1015.  */
  1016. DEFINE_GUID(IID_IHXRendererAdviseSink, 0x0000040D, 0x901, 
  1017.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1019. #undef  INTERFACE
  1020. #define INTERFACE   IHXRendererAdviseSink
  1022. DECLARE_INTERFACE_(IHXRendererAdviseSink, IUnknown)
  1023. {
  1024.     /*
  1025.      * IUnknown methods
  1026.      */
  1027.     STDMETHOD(QueryInterface) (THIS_
  1028. REFIID riid,
  1029. void** ppvObj) PURE;
  1031.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1033.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1035.     /*
  1036.      * IHXRendererAdviseSink methods
  1037.      */
  1039.     STDMETHOD(TrackDurationSet) (THIS_
  1040. UINT32 ulGroupIndex,
  1041. UINT32 ulTrackIndex,
  1042. UINT32 ulDuration,
  1043. UINT32 ulDelay,
  1044. BOOL   bIsLive) PURE;
  1046.     STDMETHOD(RepeatedTrackDurationSet) (THIS_
  1047. const char*  pID,
  1048. UINT32 ulDuration,
  1049.         BOOL   bIsLive) PURE;
  1051.     STDMETHOD(TrackUpdated) (THIS_
  1052. UINT32 ulGroupIndex,
  1053. UINT32 ulTrackIndex,
  1054. IHXValues* pValues) PURE;
  1056.    /************************************************************************
  1057.    *  Method:
  1058.    *      IHXRendererAdviseSink::RendererInitialized
  1059.    *  Purpose:
  1060.    *   Notification of renderer initialization
  1061.    * 
  1062.    */
  1063.     STDMETHOD(RendererInitialized) (THIS_
  1064. IHXRenderer* pRenderer,
  1065. IUnknown* pStream,
  1066. IHXValues* pInfo) PURE;
  1068.    /************************************************************************
  1069.    *  Method:
  1070.    *      IHXRendererAdviseSink::RendererClosed
  1071.    *  Purpose:
  1072.    *   Notification of renderer close
  1073.    * 
  1074.    */
  1075.     STDMETHOD(RendererClosed) (THIS_
  1076. IHXRenderer* pRenderer,
  1077. IHXValues* pInfo) PURE;
  1078. };
  1081. /****************************************************************************
  1082.  * 
  1083.  *  Interface:
  1084.  *
  1085.  * IHXLayoutStream
  1086.  *
  1087.  *  Purpose:
  1088.  *
  1089.  * Interface that allows access/updates to stream properties
  1090.  *
  1091.  *  IID_IHXLayoutStream:
  1092.  *
  1093.  * {0000040E-0901-11d1-8B06-00A024406D59}
  1094.  *
  1095.  */
  1096. DEFINE_GUID(IID_IHXLayoutStream, 0x0000040E, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1097. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1099. #undef  INTERFACE
  1100. #define INTERFACE   IHXLayoutStream
  1102. DECLARE_INTERFACE_(IHXLayoutStream, IUnknown)
  1103. {
  1104.     /*
  1105.      * IUnknown methods
  1106.      */
  1107.     STDMETHOD(QueryInterface) (THIS_
  1108. REFIID riid,
  1109. void** ppvObj) PURE;
  1111.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1113.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1115.     /*
  1116.      * IHXLayoutStream methods
  1117.      */
  1119.     /************************************************************************
  1120.      * Method:
  1121.      *     IHXLayoutStream::GetProperty
  1122.      * Purpose:
  1123.      *     Get layout stream property
  1124.      *     
  1125.      *
  1126.      */
  1127.     STDMETHOD(GetProperties) (THIS_
  1128. REF(IHXValues*) pValue) PURE;
  1130.     /************************************************************************
  1131.      * Method:
  1132.      *     IHXLayoutStream::SetProperty
  1133.      * Purpose:
  1134.      *     Set layout stream property
  1135.      *
  1136.      */
  1137.     STDMETHOD(SetProperties) (THIS_
  1138. IHXValues* pValue) PURE;
  1139. };
  1141. /****************************************************************************
  1142.  * 
  1143.  *  Interface:
  1144.  *
  1145.  * IHXRendererUpgrade
  1146.  *
  1147.  *  Purpose:
  1148.  *
  1149.  * Interface that tells the player to upgrade a particular set of renderers
  1150.  *
  1151.  *  IID_IHXRendererUpgrade:
  1152.  *
  1153.  * {00000410-0901-11d1-8B06-00A024406D59}
  1154.  *
  1155.  */
  1156. DEFINE_GUID(IID_IHXRendererUpgrade, 0x00000410, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1157. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1159. #undef  INTERFACE
  1160. #define INTERFACE   IHXRendererUpgrade
  1162. DECLARE_INTERFACE_(IHXRendererUpgrade, IUnknown)
  1163. {
  1164.     /*
  1165.      * IUnknown methods
  1166.      */
  1167.     STDMETHOD(QueryInterface) (THIS_
  1168. REFIID riid,
  1169. void** ppvObj) PURE;
  1171.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1173.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1175.     /*
  1176.      * IHXRendererUpgrade methods
  1177.      */
  1179.     /************************************************************************
  1180.      * Method:
  1181.      *     IHXRendererUpgrade::IsRendererAvailable
  1182.      * Purpose:
  1183.      *     Find out if the renderer is already loaded
  1184.      *     
  1185.      *
  1186.      */
  1187.     STDMETHOD_(BOOL,IsRendererAvailable) (THIS_
  1188. const char* pMimeType) PURE;
  1190.     /************************************************************************
  1191.      * Method:
  1192.      *     IHXRendererUpgrade::ForceUpgrade
  1193.      * Purpose:
  1194.      *     Force an upgrade for any unloaded renderers
  1195.      *
  1196.      */
  1197.     STDMETHOD(ForceUpgrade) (THIS) PURE;
  1198. };
  1200. /****************************************************************************
  1201.  * 
  1202.  *  Interface:
  1203.  *
  1204.  * IHXValidator
  1205.  *
  1206.  *  Purpose:
  1207.  *
  1208.  * Interface that provides validation
  1209.  *
  1210.  *  IID_IHXValidator:
  1211.  *
  1212.  * {00000412-0901-11d1-8B06-00A024406D59}
  1213.  *
  1214.  */
  1215. DEFINE_GUID(IID_IHXValidator, 0x00000412, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1216. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1218. #undef  INTERFACE
  1219. #define INTERFACE   IHXValidator
  1221. DECLARE_INTERFACE_(IHXValidator, IUnknown)
  1222. {
  1223.     /*
  1224.      * IUnknown methods
  1225.      */
  1226.     STDMETHOD(QueryInterface) (THIS_
  1227. REFIID riid,
  1228. void** ppvObj) PURE;
  1230.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1232.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1234.     /*
  1235.      * IHXValidator methods
  1236.      */
  1238.     /************************************************************************
  1239.      * Method:
  1240.      *     IHXValidator::ValidateProtocol
  1241.      * Purpose:
  1242.      *     Find out if the protocol is valid
  1243.      *     
  1244.      *
  1245.      */
  1246.     STDMETHOD_(BOOL,ValidateProtocol) (THIS_
  1247.  char* pProtocol) PURE;
  1249.     /************************************************************************
  1250.      * Method:
  1251.      *     IHXValidator::ValidateMetaFile
  1252.      * Purpose:
  1253.      *     Find out if it is a meta file
  1254.      *     
  1255.      *
  1256.      */
  1257.     STDMETHOD(ValidateMetaFile) (THIS_
  1258.  IHXRequest* pRequest,
  1259.  IHXBuffer* pContent) PURE;
  1260. };
  1262. /****************************************************************************
  1263.  * 
  1264.  *  Interface:
  1265.  *
  1266.  * IHXPrivateStreamSource
  1267.  *
  1268.  *  Purpose:
  1269.  * This interface is being added for the sole purpose of implementing 
  1270.  * IsSaveAllowed on our stream source objects.  We need to get this in
  1271.  * for alpha-3 of the player, since it would be very bad to put out a 
  1272.  * player version that allowed recording of content that was supposed to
  1273.  * be unrecordable.  This method should be moved into IHXStreamSource
  1274.  * as soon as is convenient.
  1275.  *
  1276.  *  IHXPrivateStreamSource:
  1277.  *
  1278.  *  {57DFD0E2-C76E-11d1-8B5C-006008065552}
  1279.  *
  1280.  */
  1281.  
  1282. DEFINE_GUID(IID_IHXPrivateStreamSource, 0x57dfd0e2, 0xc76e, 0x11d1, 0x8b, 0x5c, 
  1283. 0x0, 0x60, 0x8, 0x6, 0x55, 0x52);
  1285. #undef  INTERFACE
  1286. #define INTERFACE   IHXPrivateStreamSource
  1288. DECLARE_INTERFACE_(IHXPrivateStreamSource, IUnknown)
  1289. {
  1290.     /*
  1291.      * IUnknown methods
  1292.      */
  1293.     STDMETHOD(QueryInterface) (THIS_
  1294. REFIID riid,
  1295. void** ppvObj) PURE;
  1297.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1299.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1301.     /*
  1302.      * IHXPrivateStreamSource methods
  1303.      */
  1306.     STDMETHOD_ (BOOL,IsSaveAllowed) (THIS) PURE;
  1308. };
  1310. // $EndPrivate.
  1312. /****************************************************************************
  1313.  * 
  1314.  *  Interface:
  1315.  *
  1316.  * IHXPlayer2
  1317.  *
  1318.  *  Purpose:
  1319.  *
  1320.  * Extra methods in addition to IHXPlayer
  1321.  *
  1322.  *  IID_IHXPlayer2:
  1323.  *
  1324.  * {00000411-0901-11d1-8B06-00A024406D59}
  1325.  *
  1326.  */
  1327. DEFINE_GUID(IID_IHXPlayer2, 0x00000411, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1328. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1330. #undef  INTERFACE
  1331. #define INTERFACE   IHXPlayer2
  1333. DECLARE_INTERFACE_(IHXPlayer2, IUnknown)
  1334. {
  1335.     /*
  1336.      * IUnknown methods
  1337.      */
  1338.     STDMETHOD(QueryInterface) (THIS_
  1339. REFIID riid,
  1340. void** ppvObj) PURE;
  1342.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1344.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1346.     /************************************************************************
  1347.      * Method:
  1348.      *     IID_IHXPlayer2::SetMinimumPreroll
  1349.      * Purpose:
  1350.      *     Call this method to set the minimum preroll of this clip
  1351.      */
  1352.     STDMETHOD(SetMinimumPreroll) (THIS_
  1353. UINT32 ulMinPreroll) PURE;
  1355.     /************************************************************************
  1356.      * Method:
  1357.      *     IID_IHXPlayer2::GetMinimumPreroll
  1358.      * Purpose:
  1359.      *     Call this method to get the minimum preroll of this clip
  1360.      */
  1361.     STDMETHOD(GetMinimumPreroll) (THIS_
  1362. REF(UINT32) ulMinPreroll) PURE;
  1364.     /************************************************************************
  1365.      * Method:
  1366.      *     IID_IHXPlayer2::OpenRequest
  1367.      * Purpose:
  1368.      *     Call this method to open the IHXRequest
  1369.      */
  1370.     STDMETHOD(OpenRequest) (THIS_
  1371.     IHXRequest* pRequest) PURE;
  1373.     /************************************************************************
  1374.      * Method:
  1375.      *     IID_IHXPlayer2::GetRequest
  1376.      * Purpose:
  1377.      *     Call this method to get the IHXRequest
  1378.      */
  1379.     STDMETHOD(GetRequest) (THIS_
  1380.    REF(IHXRequest*) pRequest) PURE;
  1381. };
  1383. // $Private:
  1384. /****************************************************************************
  1385.  * 
  1386.  *  Interface:
  1387.  *
  1388.  * IHXUpdateProperties
  1389.  *
  1390.  *  Purpose:
  1391.  *
  1392.  * update any offset related stuff
  1393.  *
  1394.  *  IID_IHXUpdateProperties:
  1395.  *
  1396.  * {00000413-0901-11d1-8B06-00A024406D59}
  1397.  *
  1398.  */
  1399. DEFINE_GUID(IID_IHXUpdateProperties, 0x00000413, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1400. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1402. #undef  INTERFACE
  1403. #define INTERFACE   IHXUpdateProperties
  1405. DECLARE_INTERFACE_(IHXUpdateProperties, IUnknown)
  1406. {
  1407.     /*
  1408.      * IUnknown methods
  1409.      */
  1410.     STDMETHOD(QueryInterface) (THIS_
  1411. REFIID riid,
  1412. void** ppvObj) PURE;
  1414.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1416.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1418.     /************************************************************************
  1419.      * Method:
  1420.      *     IHXUpdateProperties::UpdatePacketTimeOffset
  1421.      * Purpose:
  1422.      *     Call this method to update the timestamp offset of cached packets
  1423.      */
  1424.     STDMETHOD(UpdatePacketTimeOffset) (THIS_
  1425.        INT32 lTimeOffset) PURE;
  1427.     /************************************************************************
  1428.      * Method:
  1429.      *     IHXUpdateProperties::UpdatePlayTimes
  1430.      * Purpose:
  1431.      *     Call this method to update properties
  1432.      */
  1433.     STDMETHOD(UpdatePlayTimes)       (THIS_
  1434.        IHXValues* pProps) PURE;
  1435. };
  1436. // $EndPrivate.
  1438. /****************************************************************************
  1439.  * 
  1440.  *  Interface:
  1441.  *
  1442.  * IHXPlayerNavigator
  1443.  *
  1444.  *  Purpose:
  1445.  *
  1446.  * navigate player objects
  1447.  *
  1448.  *  IID_IHXPlayerNavigator:
  1449.  *
  1450.  * {00000414-0901-11d1-8B06-00A024406D59}
  1451.  *
  1452.  */
  1453. DEFINE_GUID(IID_IHXPlayerNavigator, 0x00000414, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1454. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1456. #undef  INTERFACE
  1457. #define INTERFACE   IHXPlayerNavigator
  1459. DECLARE_INTERFACE_(IHXPlayerNavigator, IUnknown)
  1460. {
  1461.     /*
  1462.      * IUnknown methods
  1463.      */
  1464.     STDMETHOD(QueryInterface) (THIS_
  1465. REFIID riid,
  1466. void** ppvObj) PURE;
  1468.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1470.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1472.     /************************************************************************
  1473.      * Method:
  1474.      *     IHXPlayerNavigator::AddChildPlayer
  1475.      * Purpose:
  1476.      *     Add child player to the current player
  1477.      */
  1478.     STDMETHOD(AddChildPlayer)     (THIS_
  1479.     IHXPlayer* pPlayer) PURE;
  1481.     /************************************************************************
  1482.      * Method:
  1483.      *     IHXPlayerNavigator::RemoveChildPlayer
  1484.      * Purpose:
  1485.      *     Remove child player from the current player
  1486.      */
  1487.     STDMETHOD(RemoveChildPlayer)    (THIS_
  1488.     IHXPlayer* pPlayer) PURE;
  1490.     /************************************************************************
  1491.      * Method:
  1492.      *     IHXPlayerNavigator::GetNumChildPlayer
  1493.      * Purpose:
  1494.      *     Get number of the child players
  1495.      */
  1496.     STDMETHOD_(UINT16, GetNumChildPlayer)    (THIS) PURE;
  1498.     /************************************************************************
  1499.      * Method:
  1500.      *     IHXPlayerNavigator::GetChildPlayer
  1501.      * Purpose:
  1502.      *     Get Nth child player
  1503.      */
  1504.     STDMETHOD(GetChildPlayer)     (THIS_
  1505.     UINT16 uPlayerIndex,
  1506.     REF(IHXPlayer*) pPlayer) PURE;
  1508.     /************************************************************************
  1509.      * Method:
  1510.      *     IHXPlayerNavigator::SetParentPlayer
  1511.      * Purpose:
  1512.      *     Set the parent player
  1513.      */
  1514.     STDMETHOD(SetParentPlayer)     (THIS_
  1515.     IHXPlayer* pPlayer) PURE;
  1517.     /************************************************************************
  1518.      * Method:
  1519.      *     IHXPlayerNavigator::RemoveParentPlayer
  1520.      * Purpose:
  1521.      *     Remove the parent player
  1522.      */
  1523.     STDMETHOD(RemoveParentPlayer)   (THIS_
  1524.     IHXPlayer* pPlayer) PURE;
  1526.     /************************************************************************
  1527.      * Method:
  1528.      *     IHXPlayerNavigator::GetParentPlayer
  1529.      * Purpose:
  1530.      *     Get the parent player
  1531.      */
  1532.     STDMETHOD(GetParentPlayer)     (THIS_
  1533.     REF(IHXPlayer*) pPlayer) PURE;
  1534. };
  1536. // $Private:
  1537. /****************************************************************************
  1538.  * 
  1539.  *  Interface:
  1540.  *
  1541.  * IHXPersistentComponentManager
  1542.  *
  1543.  *  Purpose:
  1544.  *
  1545.  * persistent component manager
  1546.  *
  1547.  *  IID_IHXPersistentComponentManager
  1548.  *
  1549.  * {00000415-0901-11d1-8B06-00A024406D59}
  1550.  *
  1551.  */
  1552. DEFINE_GUID(IID_IHXPersistentComponentManager, 0x00000415, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1553. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1555. #undef  INTERFACE
  1556. #define INTERFACE   IHXPersistentComponentManager
  1558. DECLARE_INTERFACE_(IHXPersistentComponentManager, IUnknown)
  1559. {
  1560.     /*
  1561.      * IUnknown methods
  1562.      */
  1563.     STDMETHOD(QueryInterface) (THIS_
  1564. REFIID riid,
  1565. void** ppvObj) PURE;
  1567.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1569.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1571.     /************************************************************************
  1572.      * Method:
  1573.      *     IHXPersistentComponentManager::CreatePersistentComponent
  1574.      * Purpose:
  1575.      *     create persistent component
  1576.      */
  1577.     STDMETHOD(CreatePersistentComponent)    (THIS_
  1578.     REF(IHXPersistentComponent*)   pPersistentComponent) PURE;
  1581.     /************************************************************************
  1582.      * Method:
  1583.      *     IHXPersistentComponentManager::AddPersistentComponent
  1584.      * Purpose:
  1585.      *     add persistent component
  1586.      */
  1587.     STDMETHOD(AddPersistentComponent)     (THIS_
  1588.     IHXPersistentComponent* pPersistentComponent) PURE;
  1590.     /************************************************************************
  1591.      * Method:
  1592.      *     IHXPersistentComponentManager::RemovePersistentComponent
  1593.      * Purpose:
  1594.      *     remove persistent component
  1595.      */
  1596.     STDMETHOD(RemovePersistentComponent)    (THIS_
  1597.     UINT32 ulPersistentComponentID) PURE;
  1599.     /************************************************************************
  1600.      * Method:
  1601.      *     IHXPersistentComponentManager::GetPersistentComponentInfo
  1602.      * Purpose:
  1603.      *     get persistent component information
  1604.      */
  1605.     STDMETHOD(GetPersistentComponent)     (THIS_
  1606.     UINT32     ulPersistentComponentID,
  1607.     REF(IHXPersistentComponent*)   pPersistentComponent) PURE;
  1609.     /************************************************************************
  1610.      * Method:
  1611.      *     IHXPersistentComponentManager::AttachPersistentComponentLayout
  1612.      * Purpose:
  1613.      *     get persistent component information
  1614.      */
  1615.     STDMETHOD(AttachPersistentComponentLayout) (THIS_
  1616. IUnknown*   pLSG,
  1617. IHXValues* pProps) PURE;
  1618. };
  1620. /****************************************************************************
  1621.  * 
  1622.  *  Interface:
  1623.  *
  1624.  * IHXPersistentComponent
  1625.  *
  1626.  *  Purpose:
  1627.  *
  1628.  * persistent component
  1629.  *
  1630.  *  IID_IHXPersistentComponent
  1631.  *
  1632.  * {00000416-0901-11d1-8B06-00A024406D59}
  1633.  *
  1634.  */
  1635. DEFINE_GUID(IID_IHXPersistentComponent, 0x00000416, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1636. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1638. #undef  INTERFACE
  1639. #define INTERFACE   IHXPersistentComponent
  1641. DECLARE_INTERFACE_(IHXPersistentComponent, IUnknown)
  1642. {
  1643.     /*
  1644.      * IUnknown methods
  1645.      */
  1646.     STDMETHOD(QueryInterface) (THIS_
  1647. REFIID riid,
  1648. void** ppvObj) PURE;
  1650.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1652.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1654.     /************************************************************************
  1655.      * Method:
  1656.      *     IHXPersistentComponent::Init
  1657.      * Purpose:
  1658.      *     initialize persistent component
  1659.      */
  1660.     STDMETHOD(Init) (THIS_
  1661.                                 IHXPersistentRenderer* pPersistentRenderer) PURE;
  1663.     /************************************************************************
  1664.      * Method:
  1665.      *     IHXPersistentComponent::AddRendererAdviseSink
  1666.      * Purpose:
  1667.      *     add renderer advise sink
  1668.      */
  1669.     STDMETHOD(AddRendererAdviseSink) (THIS_
  1670.                                 IHXRendererAdviseSink* pSink) PURE;
  1672.     /************************************************************************
  1673.      * Method:
  1674.      *     IHXPersistentComponent::RemoveRendererAdviseSink
  1675.      * Purpose:
  1676.      *     remove renderer advise sink
  1677.      */
  1678.     STDMETHOD(RemoveRendererAdviseSink) (THIS_
  1679.                                 IHXRendererAdviseSink* pSink) PURE;
  1681.     /************************************************************************
  1682.      * Method:
  1683.      *     IHXPersistentComponent::AddGroupSink
  1684.      * Purpose:
  1685.      *     add renderer advise sink
  1686.      */
  1687.     STDMETHOD(AddGroupSink) (THIS_
  1688.                                 IHXGroupSink* pSink) PURE;
  1690.     /************************************************************************
  1691.      * Method:
  1692.      *     IHXPersistentComponent::RemoveGroupSink
  1693.      * Purpose:
  1694.      *     remove renderer advise sink
  1695.      */
  1696.     STDMETHOD(RemoveGroupSink) (THIS_
  1697.                                 IHXGroupSink* pSink) PURE;
  1699.     /************************************************************************
  1700.      * Method:
  1701.      *     IHXPersistentComponent::GetPersistentRenderer
  1702.      * Purpose:
  1703.      *     get persistent renderer
  1704.      */
  1705.     STDMETHOD(GetPersistentRenderer) (THIS_
  1706.                                 REF(IHXPersistentRenderer*) pPersistentRenderer) PURE;
  1708.     /************************************************************************
  1709.      * Method:
  1710.      *     IHXPersistentComponent::GetPersistentProperties
  1711.      * Purpose:
  1712.      *     get persistent component properties
  1713.      */
  1714.     STDMETHOD(GetPersistentProperties) (THIS_
  1715.                                 REF(IHXValues*) pProperties) PURE;
  1716. };
  1718. /****************************************************************************
  1719.  * 
  1720.  *  Interface:
  1721.  *
  1722.  * IID_IHXClientStatisticsGranularity
  1723.  *
  1724.  *  Purpose:
  1725.  *
  1726.  * Enables users to set the Granularity at which statistics are 
  1727.  * gathered. This allows machines under high load to still run
  1728.  * efficiently.
  1729.  *
  1730.  *
  1731.  *  IID_IHXClientStatisticsGranularity
  1732.  *
  1733.  * {00000416-0901-11d1-8B06-00A024406D59}
  1734.  *
  1735.  */
  1736. DEFINE_GUID(IID_IHXClientStatisticsGranularity, 0x00000417, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1737. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1739. #undef  INTERFACE
  1740. #define INTERFACE   IHXClientStatisticsGranularity
  1742. DECLARE_INTERFACE_(IHXClientStatisticsGranularity, IUnknown)
  1743. {
  1744.     /*
  1745.      * IUnknown methods
  1746.      */
  1747.     STDMETHOD(QueryInterface) (THIS_
  1748. REFIID riid,
  1749. void** ppvObj) PURE;
  1751.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1753.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1755.     /************************************************************************
  1756.      * Method:
  1757.      *     IHXClientStatisticsGranularity::SetStatsGranularity
  1758.      * Purpose:
  1759.      *     Set the granularity
  1760.      */
  1761.     STDMETHOD(SetStatsGranularity) (THIS_ ULONG32 ulGranularity) PURE;
  1762. };
  1764. // $EndPrivate.
  1766. // $Private:
  1768. /****************************************************************************
  1769.  * 
  1770.  *  Interface:
  1771.  *
  1772.  * IID_IHXSourceBufferingStats
  1773.  *
  1774.  *  Purpose:
  1775.  *
  1776.  * Enables users to get the current buffering status of the 
  1777.  * given source. 
  1778.  *
  1779.  *
  1780.  *      IID_IHXSourceBufferingStats
  1781.  *
  1782.  * {00000418-0901-11d1-8B06-00A024406D59}
  1783.  *
  1784.  */
  1785. DEFINE_GUID(IID_IHXSourceBufferingStats, 0x00000418, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1786. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1788. #undef  INTERFACE
  1789. #define INTERFACE   IHXSourceBufferingStats
  1791. DECLARE_INTERFACE_(IHXSourceBufferingStats, IUnknown)
  1792. {
  1793.     /************************************************************************
  1794.      * Method:
  1795.      *     IHXSourceBufferingStats::GetCurrentBuffering
  1796.      * Purpose:
  1797.      *     Get the current buffering information
  1798.      */
  1800.     STDMETHOD(GetCurrentBuffering)  (THIS_ UINT16  uStreamNumber,
  1801.      REF(INT64)  llLowestTimestamp, 
  1802.      REF(INT64)  llHighestTimestamp,
  1803.      REF(UINT32) ulNumBytes,
  1804.      REF(BOOL)   bDone) PURE;
  1805. };
  1808. /****************************************************************************
  1809.  * 
  1810.  *  Interface:
  1811.  *
  1812.  * IID_IHXSourceBufferingStats2
  1813.  *
  1814.  *  Purpose:
  1815.  *
  1816.  * Enables users to get the current buffering status of the 
  1817.  * given source. 
  1818.  *
  1819.  *
  1820.  *      IID_IHXSourceBufferingStats2
  1821.  *
  1822.  * {00000418-0901-11d1-8B06-00A024406D5A}
  1823.  *
  1824.  */
  1825. DEFINE_GUID(IID_IHXSourceBufferingStats2, 0x00000418, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1826. 0xa0, 0x24, 0x40, 0x6d, 0x5a);
  1828. #undef  INTERFACE
  1829. #define INTERFACE   IHXSourceBufferingStats2
  1831. DECLARE_INTERFACE_(IHXSourceBufferingStats2, IHXSourceBufferingStats)
  1832. {
  1833.     /************************************************************************
  1834.      * Method:
  1835.      *     IHXSourceBufferingStats2::GetCurrentBuffering
  1836.      * Purpose:
  1837.      *     Get the amount of buffering in the transport
  1838.      */
  1839.     STDMETHOD(GetCurrentBuffering)  (THIS_ UINT16  uStreamNumber,
  1840.      REF(INT64)  llLowestTimestamp, 
  1841.      REF(INT64)  llHighestTimestamp,
  1842.      REF(UINT32) ulNumBytes,
  1843.      REF(BOOL)   bDone) PURE;
  1845.     /************************************************************************
  1846.      * Method:
  1847.      *     IHXSourceBufferingStats2::GetTotalBuffering
  1848.      * Purpose:
  1849.      *     Get the total amount of data buffered for a stream.
  1850.      *      This includes what is in the transport buffer and in
  1851.      *      the renderer
  1852.      */
  1854.     STDMETHOD(GetTotalBuffering)  (THIS_ UINT16  uStreamNumber,
  1855.    REF(INT64)  llLowestTimestamp, 
  1856.    REF(INT64)  llHighestTimestamp,
  1857.    REF(UINT32) ulNumBytes,
  1858.    REF(BOOL)   bDone) PURE;
  1859. };
  1861. // $EndPrivate.
  1863. // $Private:
  1865. /****************************************************************************
  1866.  * 
  1867.  *  Interface:
  1868.  *
  1869.  * IID_IHXPlayerPresentation
  1870.  *
  1871.  *  Purpose:
  1872.  *
  1873.  * Control over the player's current presentation
  1874.  *
  1875.  *      IID_IHXPlayerPresentation
  1876.  *
  1877.  * {6DE011A7-EF05-417b-9367-6FE0E54302D3}
  1878.  *
  1879.  */
  1880. DEFINE_GUID(IID_IHXPlayerPresentation, 0x6de011a7, 0xef05, 0x417b, 0x93, 0x67, 0x6f, 0xe0, 0xe5, 0x43, 0x2, 0xd3);
  1882. #undef  INTERFACE
  1883. #define INTERFACE   IHXPlayerPresentation
  1885. DECLARE_INTERFACE_(IHXPlayerPresentation, IUnknown)
  1886. {
  1887.     /************************************************************************
  1888.      * Method:
  1889.      *     IHXPlayerPresentation::ClosePresentation
  1890.      * Purpose:
  1891.      *     Call this method to close the player's current presentation.  This will free
  1892.      *     all resources associated with the current presentation.
  1893.      */
  1894.     STDMETHOD(ClosePresentation)    (THIS) PURE;
  1895. };
  1897. // $EndPrivate.
  1901. // $Private:
  1903. /****************************************************************************
  1904.  * 
  1905.  *  Interface:
  1906.  *
  1907.  * IID_IHXCoreMutex
  1908.  *
  1909.  *  Purpose:
  1910.  *
  1911.  * Access the core mutex
  1912.  *
  1913.  *      IID_IHXCoreMutex
  1914.  *
  1915.  * {6DE011A7-EF05-417b-9367-6FE0E44404D4}
  1916.  *
  1917.  */
  1918. DEFINE_GUID(IID_IHXCoreMutex, 0x6de011a7, 0xef05, 0x417b, 0x93, 0x67, 0x6f, 0xe0, 0xe4, 0x44, 0x4, 0xd4);
  1920. #undef  INTERFACE
  1921. #define INTERFACE   IHXCoreMutex
  1923. DECLARE_INTERFACE_(IHXCoreMutex, IUnknown)
  1924. {
  1925.     /************************************************************************
  1926.      * Method:
  1927.      *     IHXCoreMutex::LockCoreMutex
  1928.      * Purpose:
  1929.      *      Call this method to lock the client engine's core mutex.
  1930.      */
  1931.     STDMETHOD(LockCoreMutex)    (THIS) PURE;
  1933.     /************************************************************************
  1934.      * Method:
  1935.      *     IHXCoreMutex::UnlockCoreMutex
  1936.      * Purpose:
  1937.      *      Call this method to unlock the client engine's core mutex.
  1938.      */
  1939.     STDMETHOD(UnlockCoreMutex)    (THIS) PURE;
  1940. };
  1943. /****************************************************************************
  1944.  * 
  1945.  *  Interface:
  1946.  *
  1947.  * IID_IHXMacBlitMutex
  1948.  *
  1949.  *  Purpose:
  1950.  *
  1951.  * Access the Mac blitting mutex
  1952.  *
  1953.  * Used for all Mac drawing, in both the core and the tlc. This
  1954.  * mutex prevents quickdraw (and/or the image compression manager)
  1955.  * from re-entering which causes crashes on OS X.
  1956.  *
  1957.  *      IID_IHXCoreMutex
  1958.  *
  1959.  * {294e6de4-fbc6-4c06-bb94-95a969373b4d}
  1960.  *
  1961.  */
  1962. DEFINE_GUID(IID_IHXMacBlitMutex, 0x294e6de4,  0xfbc6,  0x4c06,  0xbb,  0x94,  0x95, 0xa9,  0x69,  0x37,  0x3b,  0x4d);
  1964. #undef  INTERFACE
  1965. #define INTERFACE   IHXMacBlitMutex
  1967. DECLARE_INTERFACE_(IHXMacBlitMutex, IUnknown)
  1968. {
  1969.     /************************************************************************
  1970.      * Method:
  1971.      *     IHXMacBlitMutex::LockMacBlitMutex
  1972.      * Purpose:
  1973.      *      Call this method to lock the client engine's core mutex.
  1974.      */
  1975.     STDMETHOD(LockMacBlitMutex)    (THIS) PURE;
  1977.     /************************************************************************
  1978.      * Method:
  1979.      *     IHXMacBlitMutex::UnlockMacBlitMutex
  1980.      * Purpose:
  1981.      *      Call this method to unlock the client engine's core mutex.
  1982.      */
  1983.     STDMETHOD(UnlockMacBlitMutex)    (THIS) PURE;
  1984. };
  1986. // $EndPrivate.
  1990. #endif /* _HXCORE_H_ */