hxmeta1.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:12k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxmeta1.h,v 1.1.50.3 2004/07/09 01:45:12 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 ***** */
  49. #ifndef _HXMETA_
  50. #define _HXMETA_
  51. /*
  52.  * Forward declarations of some interfaces defined or used here-in.
  53.  */
  54. typedef struct _HXxWindow   HXxWindow;
  55. typedef _INTERFACE IUnknown IUnknown;
  56. typedef _INTERFACE IHXFileSystemObject IHXFileSystemObject;
  57. typedef _INTERFACE IHXFileObject IHXFileObject;
  58. typedef _INTERFACE IHXRequest IHXRequest;
  59. typedef _INTERFACE IHXMetaGroup IHXMetaGroup;
  60. typedef _INTERFACE IHXSiteLayout IHXSiteLayout;
  61. typedef _INTERFACE IHXMetaFileFormatObject IHXMetaFileFormatObject;
  62. typedef _INTERFACE IHXMetaFileFormatResponse IHXMetaFileFormatResponse;
  63. enum GROUP_TYPE
  64. {
  65.     SEQUENCE_GROUP,
  66.     PARALLEL_GROUP,
  67.     SWITCH_GROUP
  68. };
  69. /****************************************************************************
  70.  * 
  71.  *  Interface:
  72.  *
  73.  * IHXMetaTrack
  74.  *
  75.  *  Purpose:
  76.  *
  77.  * This interface allows access to a track's properties with special
  78.  * functions to get a track's layout & channel.
  79.  *
  80.  *
  81.  *  IID_IHXMetaTrack:
  82.  *
  83.  * {00000E01-0901-11d1-8B06-00A024406D59}
  84.  *
  85.  */
  86. DEFINE_GUID(IID_IHXMetaTrack, 0x00000E01, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  87. 0xa0, 0x24, 0x40, 0x6d, 0x59); 
  88. #undef  INTERFACE
  89. #define INTERFACE   IHXMetaTrack
  90. DECLARE_INTERFACE_(IHXMetaTrack, IUnknown)
  91. {
  92.     /*
  93.      * IUnknown methods
  94.      */
  95.     STDMETHOD(QueryInterface) (THIS_
  96. REFIID riid,
  97. void** ppvObj) PURE;
  98.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  99.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  100.     /*
  101.      * IHXMetaTrack methods
  102.      */
  103.     /************************************************************************
  104.      * Method:
  105.      *     IHXMetaGroup::GetStreamCount
  106.      * Purpose:
  107.      *     Gets a count of the number of streams exposed by this track
  108.      */
  109.     STDMETHOD_(INT32,GetStreamCount) (THIS) PURE;
  110.     /************************************************************************
  111.      * Method:
  112.      *     IHXMetaTrack::GetStreamById
  113.      * Purpose:
  114.      *     Gets a stream object whose "ID" property equals nStreamID
  115.      *     file group.
  116.      */
  117.     STDMETHOD(GetStreamById)  (THIS_
  118.    INT32 /*IN*/  nStreamID,
  119.        REF(IUnknown*) /*OUT*/ pStream) PURE;
  120.     /************************************************************************
  121.      * Method:
  122.      *     IHXMetaTrack::GetStreamByName
  123.      * Purpose:
  124.      *     Gets a stream object whose "ID" property equals nStreamID
  125.      *     file group.
  126.      */
  127.     STDMETHOD(GetStreamByName)  (THIS_
  128.    const char* /*IN*/  pName,
  129.        REF(IUnknown*) /*OUT*/ pStream) PURE;
  130. };
  131. /****************************************************************************
  132.  * 
  133.  *  Interface:
  134.  *
  135.  * IHXMetaGroup
  136.  *
  137.  *  Purpose:
  138.  *
  139.  * This interface allows access to a group's properties with special
  140.  * functions to get a track's layout.
  141.  *
  142.  *
  143.  *  IID_IHXMetaGroup:
  144.  *
  145.  * {00000E02-0901-11d1-8B06-00A024406D59}
  146.  *
  147.  */
  148. DEFINE_GUID(IID_IHXMetaGroup, 0x00000E02, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  149. 0xa0, 0x24, 0x40, 0x6d, 0x59); 
  150. #undef  INTERFACE
  151. #define INTERFACE   IHXMetaGroup
  152. DECLARE_INTERFACE_(IHXMetaGroup, IUnknown)
  153. {
  154.     /*
  155.      * IUnknown methods
  156.      */
  157.     STDMETHOD(QueryInterface) (THIS_
  158. REFIID riid,
  159. void** ppvObj) PURE;
  160.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  161.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  162.     /*
  163.      * IHXMetaGroup methods
  164.      */
  165.     /************************************************************************
  166.      * Method:
  167.      *     IHXMetaGroup::GetTrackCount
  168.      * Purpose:
  169.      *     Gets a count of the number of tracks exposed by this meta file
  170.      *     group.
  171.      */
  172.     STDMETHOD_(INT32,GetTrackCount) (THIS) PURE;
  173.     /************************************************************************
  174.      * Method:
  175.      *     IHXMetaGroup::GetTrack
  176.      * Purpose:
  177.      *     Gets a track object of the numbered track exposed by this meta 
  178.      *     file group.
  179.      */
  180.     STDMETHOD(GetTrack) (THIS_
  181. INT32 /*IN*/  nTrackNumber,
  182.     REF(IHXMetaTrack*) /*OUT*/ pTrack) PURE;
  183.     /************************************************************************
  184.      * Method:
  185.      *     IHXMetaGroup::GetLayoutCount
  186.      * Purpose:
  187.      *     Gets a count of the number of Layouts exposed by this meta file
  188.      *     group.
  189.      */
  190.     STDMETHOD_(INT32,GetLayoutCount) (THIS) PURE;
  191.     /************************************************************************
  192.      * Method:
  193.      *     IHXMetaGroup::GetLayout
  194.      * Purpose:
  195.      *     Gets a Layout object of the numbered Layout exposed by this meta 
  196.      *     file group.
  197.      */
  198.     STDMETHOD(GetLayoutSite)(THIS_
  199.    REF(IHXSiteLayout*) /*OUT*/ pLayout) PURE;
  200.     STDMETHOD(GetLayout)(THIS_
  201. INT32 /*IN*/  nLayoutNumber,
  202.     REF(IUnknown*) /*OUT*/ pUnknown)PURE;
  203. };
  204. /****************************************************************************
  205.  * 
  206.  *  Interface:
  207.  * 
  208.  * IHXMetaFileFormatObject
  209.  * 
  210.  *  Purpose:
  211.  * 
  212.  * This interface allows a new meta-file format to be pluged into
  213.  * the client application.
  214.  * 
  215.  *  IID_IHXMetaFileFormatObject:
  216.  * 
  217.  * {00000E05-0901-11d1-8B06-00A024406D59}
  218.  * 
  219.  */
  220. DEFINE_GUID(IID_IHXMetaFileFormatObject, 0x00000E05, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  221. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  222. #undef  INTERFACE
  223. #define INTERFACE   IHXMetaFileFormatObject
  224. DECLARE_INTERFACE_(IHXMetaFileFormatObject, IUnknown)
  225. {
  226. /*
  227.  * IUnknown methods
  228.  */
  229.     STDMETHOD(QueryInterface) (THIS_
  230. REFIID riid,
  231. void** ppvObj) PURE;
  232.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  233.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  234. /*
  235.  * IHXMetaFileFormatObject methods
  236.  */
  237.     /************************************************************************
  238.      * Method:
  239.      *     IHXMetaFileFormatObject::GetMetaFileFormatInfo
  240.      * Purpose:
  241.      *     Returns information vital to the instantiation of meta file 
  242.      *     format plugins.
  243.      */
  244.     STDMETHOD(GetMetaFileFormatInfo)
  245. (THIS_
  246. REF(const char**) /*OUT*/ pFileMimeTypes,
  247. REF(const char**) /*OUT*/ pFileExtensions,
  248. REF(const char**) /*OUT*/ pFileOpenNames
  249. ) PURE;
  250.     STDMETHOD(InitMetaFileFormat)
  251. (THIS_
  252.      IHXRequest*          /*IN*/  pRequest,
  253. IHXMetaFileFormatResponse* /*IN*/  pMetaResponse,
  254. IHXFileObject*     /*IN*/  pFileObject
  255. ) PURE;
  256.     /************************************************************************
  257.      * Method:
  258.      *     IHXMetaGroup::GetGroupCount
  259.      * Purpose:
  260.      *     Gets a count of the number of Groups exposed by this meta file
  261.      *     group.
  262.      */
  263.     STDMETHOD_(INT32,GetGroupCount) (THIS) PURE;
  264.     /************************************************************************
  265.      * Method:
  266.      *     IHXMetaGroup::GetGroup
  267.      * Purpose:
  268.      *     Gets a Group object of the numbered Group exposed by this meta 
  269.      *     file group.
  270.      */
  271.     STDMETHOD(GetGroup) (THIS_
  272. INT32 /*IN*/  nGroupNumber,
  273.     REF(IHXMetaGroup*) /*OUT*/ pGroup) PURE;
  274.     STDMETHOD(Close) (THIS) PURE;
  275. };
  276. /****************************************************************************
  277.  * 
  278.  *  Interface:
  279.  * 
  280.  * IHXMetaFileFormatResponse
  281.  * 
  282.  *  Purpose:
  283.  * 
  284.  * This interface allows a new meta-file format to be pluged into
  285.  * the client application.
  286.  * 
  287.  *  IID_IHXMetaFileFormatResponse:
  288.  * 
  289.  * {00000E06-0901-11d1-8B06-00A024406D59}
  290.  * 
  291.  */
  292. DEFINE_GUID(IID_IHXMetaFileFormatResponse, 0x00000E06, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  293. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  294. #undef  INTERFACE
  295. #define INTERFACE   IHXMetaFileFormatResponse
  296. DECLARE_INTERFACE_(IHXMetaFileFormatResponse, IUnknown)
  297. {
  298. /*
  299.  * IUnknown methods
  300.  */
  301.     STDMETHOD(QueryInterface) (THIS_
  302. REFIID riid,
  303. void** ppvObj) PURE;
  304.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  305.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  306. /*
  307.  * IHXMetaFileFormatResponse methods
  308.  */
  309.     /************************************************************************
  310.      * Method:
  311.      *     IHXMetaFileFormatResponse::InitDone
  312.      * Purpose:
  313.      *     Call to inform the metafile format response that the metafile
  314.      *     format plugin has completed the initialization of the metafile,
  315.      *     and is ready to respond to queries.
  316.      *
  317.      *     Use HXR_OK if the create was succesful
  318.      *
  319.      *     Use HXR_FAILED if the contents of the file was not valid
  320.      *     or if the creation failed for some reason.
  321.      */
  322.     STDMETHOD(InitDone)   (THIS_
  323.     HX_RESULT status) PURE;
  324. };
  325. /****************************************************************************
  326.  * 
  327.  *  Interface:
  328.  *
  329.  * IHXSiteLayout
  330.  *
  331.  *  Purpose:
  332.  *
  333.  * Interface for IHXSiteLayout...
  334.  *
  335.  *  IID_IHXSiteLayout:
  336.  *
  337.  * {00000E07-0901-11d1-8B06-00A024406D59}
  338.  *
  339.  */
  340. DEFINE_GUID(IID_IHXSiteLayout, 0x00000E07, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  341. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  342. #undef  INTERFACE
  343. #define INTERFACE   IHXSiteLayout
  344. DECLARE_INTERFACE_(IHXSiteLayout, IUnknown)
  345. {
  346.     /*
  347.      * IUnknown methods
  348.      */
  349.     STDMETHOD(QueryInterface) (THIS_
  350. REFIID riid,
  351. void** ppvObj) PURE;
  352.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  353.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  354.     /*
  355.      * IHXSiteLayout methods called the client core.
  356.      */
  357.     STDMETHOD_(ULONG32,GetLayoutSiteGroupCount) (THIS) PURE;
  358.     STDMETHOD(GetLayoutSiteGroup) (THIS_ 
  359. ULONG32 nGroupNumber,
  360. REF(IUnknown*) pLSG) PURE;
  361. };
  362. #endif /* _HXMETA_ */