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

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxdtdr.h,v 1.1.28.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 ***** */
  49. #ifndef _HXDTDR_H_
  50. #define _HXDTDR_H_
  51. /****************************************************************************
  52.  * Defines
  53.  */
  54. typedef _INTERFACE      IHXPacket                  IHXPacket;
  55. typedef _INTERFACE      IHXValues                  IHXValues;
  56. typedef _INTERFACE      IHXSourceInput             IHXSourceInput;
  57. typedef _INTERFACE      IHXFileWriter    IHXFileWriter;
  58. typedef _INTERFACE      IHXSourceHandler           IHXSourceHandler;
  59. /****************************************************************************
  60.  * Options
  61.  */
  62. #define MEMORY_OPTION_NAME     "Memory"
  63. #define HEADER_OPTION_NAME     "Header"
  64. #define PACKET_OPTION_NAME     "Packet"
  65. #define VERBOSE_OPTION_NAME     "Verbose"
  66. #define LEAKANALYSIS_OPTION_NAME    "LeakAnalysis"
  67. #define LEAKDETAILS_OPTION_NAME     "LeakDetails"
  68. #define MEMORYDETAILS_OPTION_NAME   "MemoryDetails"
  69. #define SERVER_OPTION_NAME     "Server"
  70. #define RATE_OPTION_NAME     "Rate"
  71. #define TIMER_OPTION_NAME     "Timer"
  72. #define EVENT_OPTION_NAME     "Event"
  73. #define DURATION_OPTION_NAME     "Duration"
  74. #define PREROLL_OPTION_NAME     "RecomputePreroll"
  75. #define BLASTFILE_OPTION_NAME     "BlastFiles"
  76. #define ROTATIONSIZE_OPTION_NAME    "RotationSize"
  77. #define RELATIVETS_OPTION_NAME     "RelativeTS"
  78. #define DECRYPT_OPTION_NAME     "DecryptSource"
  79. #define DECODE_OPTION_NAME     "DecodeSource"
  80. #define BLOCK_OPTION_NAME     "BlockFilter"
  81. #define SUPPRESS_WRITER_OPTION     "SuppressWriter"
  82. #define OUTPUT_FILENAME_OPTION     "OutputFileName"
  83. #define TRANSFER_CERTIFICATE_OPTION "TransferCertificate"
  84. //e1ec2c5f-7f0c-4348-b3b0c4af5eae9778
  85. #define SHID_DECODER   {0xe1ec2c5f, 0x7f0c, 0x4348, 0xb3, 0xb0, 0xc4, 0xaf, 0x5e, 0xae, 0x97, 0x78}
  86. /****************************************************************************
  87.  * 
  88.  *  Interface:
  89.  * 
  90.  * IHXDataTypeDriverResponse
  91.  * 
  92.  *  Purpose:
  93.  * 
  94.  * Interface used to check the state of plugins.
  95.  * 
  96.  *  IHXDataTypeDriverResponse:
  97.  * 
  98.  *  {9D65E58D-9B4B-40f2-8FF0-5CFF673F0BD3}
  99.  * 
  100.  */
  101. DEFINE_GUID(IID_IHXDataTypeDriverResponse, 0x9d65e58d, 0x9b4b, 0x40f2, 0x8f, 0xf0, 0x5c, 0xff, 0x67, 0x3f, 0xb, 0xd3);
  102.  
  103. #undef  INTERFACE
  104. #define INTERFACE   IHXDataTypeDriverResponse
  105.  
  106. DECLARE_INTERFACE_(IHXDataTypeDriverResponse, IUnknown)
  107. {
  108.     /*
  109.      * IHXDataTypeDriverResponse methods
  110.      */
  111.  
  112.     /************************************************************************
  113.      * Method:
  114.      *     IHXDataTypeDriverResponse::OnProgress(UINT32);
  115.      * Purpose:
  116.      *     Called to notify the status of the transfer
  117.      *     
  118.      */
  119.     STDMETHOD(OnProgress)(THIS_ UINT32 progress) PURE;
  120.     /************************************************************************
  121.      * Method:
  122.      *     IHXDataTypeDriverResponse::OnTerminate(HX_RESULT);
  123.      * Purpose:
  124.      *     Called when the datatype driver is done, with the appropriate 
  125.      *     error condition.
  126.      */
  127.     STDMETHOD(OnTerminate)(THIS_ HX_RESULT result) PURE;
  128. };
  129. /****************************************************************************
  130.  * 
  131.  *  Interface:
  132.  * 
  133.  * IHXDataTypeDriver2
  134.  * 
  135.  *  Purpose:
  136.  * 
  137.  *  New interface for datatype driver.
  138.  * 
  139.  *  IHXDataTypeDriver2:
  140.  * 
  141.  *  {9D65E58E-9B4B-40f2-8FF0-5CFF673F0BD3}
  142.  * 
  143.  */
  144. DEFINE_GUID(IID_IHXDataTypeDriver2, 0x9d65e58e, 0x9b4b, 0x40f2, 0x8f, 0xf0, 0x5c, 0xff, 0x67, 0x3f, 0xb, 0xd3);
  145.  
  146. #undef  INTERFACE
  147. #define INTERFACE   IHXDataTypeDriver2
  148. DECLARE_INTERFACE_(IHXDataTypeDriver2, IUnknown)
  149. {
  150.     /*
  151.      * IHXDataTypeDriver2 methods
  152.      */
  153.  
  154.     /************************************************************************
  155.      * Method:
  156.      *     IHXDataTypeDriver2::Open()
  157.      * Purpose:
  158.      *     Called to initialize the driver.
  159.      *     Note: all callbacks on the pResponse will be on the same thread 
  160.      *     that called function.
  161.      *   
  162.      *     the data output from the last source handler will be provided to an
  163.      *     IHXSourceInput. IHXDataTypeDriverResponse is useful for 
  164.      *     monitoring transfer/decode/decrypt progress and error conditions.     
  165.      *    
  166.      *     the source handler list used is the concatenation of handlers from 
  167.      *     pCertificate, pSourceHandlerGUIDs and pSourceHandlerList, in that order.
  168.      *     any of the above three can be null
  169.      *
  170.      *     pOption can be used to pass option values to both FFDRIVER and source
  171.      *     handlers
  172.      *
  173.      *     'decrypt' can only be signaled by the presence of a pCertificate
  174.      *     'decode'  can be signaled by setting the value in pOptions
  175.      *       but if pCertificate is present, it overwrites 
  176.      *       'decode' setting in pOptions
  177.      *
  178.      */
  179.     STDMETHOD(Open) (THIS_ 
  180.      const char* pCertificate,
  181.      int nSourceHandlerGUIDs,
  182.      GUID*   pSourceHandlerGUIDs,
  183.      int nSourceHandlerList,
  184.      IHXSourceHandler** pSourceHandlerList,
  185.      IHXValues* pOptions,
  186.      IHXDataTypeDriverResponse* pResponse,
  187.      IHXSourceInput* pSourceInput
  188.     ) PURE;
  189.  
  190.     /************************************************************************
  191.      * Method:
  192.      *     IHXDataTypeDriver2::Drive()
  193.      * Purpose:
  194.      *     Called to start processing. This will start the conversion in
  195.      *      a separate thread and return immediately. The client will
  196.      *     receive callbacks through pResponse's IHXSourceInput and/or 
  197.      *     IHXDataTypeDriverResponse interfaces (see Open()).
  198.      *
  199.      *     Drive() may be called multiple times without calling Close()
  200.      *     to process multiple files with the same driver settings.
  201.      *     
  202.      */
  203.     STDMETHOD(Drive)(THIS_ const char* pInFileName,
  204.      const char* pOutFileName
  205.      ) PURE;
  206.     /************************************************************************
  207.      * Method:
  208.      *      IHXDataTypeDriver2::Stop()
  209.      * Purpose:
  210.      *     Called to stop Drive. Can be called from a different thread, or 
  211.      *     called from a call back.
  212.      */
  213.     STDMETHOD(Stop)(THIS_ ) PURE;
  214.     /************************************************************************
  215.      * Method:
  216.      *     IHXDataTypeDriver2::Close()
  217.      * Purpose:
  218.      *     Called to clean up the driver process. If called while still
  219.      *     processing a file, the operation will be terminated. The driver
  220.      *     will need to be reinitialized by calling Open() before it can
  221.      *     be used again.
  222.      *
  223.      */
  224.     STDMETHOD(Close)(THIS) PURE;
  225.     /************************************************************************
  226.      * Method:
  227.      *     IHXDataTypeDriver2::Pause()
  228.      * Purpose:
  229.      *     Called to throttle delivery. No more callbacks will be made
  230.      *    until Resume() is called. 
  231.      */
  232.     STDMETHOD(Pause)(THIS) PURE;
  233.     /************************************************************************
  234.      * Method:
  235.      *     IHXDataTypeDriver2::Resume()
  236.      * Purpose:
  237.      *     Called to resume delivery
  238.      */
  239.     STDMETHOD(Resume)(THIS) PURE;
  240. };
  241. /****************************************************************************
  242.  * 
  243.  *  Interface:
  244.  * 
  245.  *  IHXSetClientContext
  246.  * 
  247.  *  Purpose:
  248.  * 
  249.  *  to set a client context
  250.  * 
  251.  *  IHXSetClientContext
  252.  * 
  253.  *  {9D65E58F-9B4B-40f2-8FF0-5CFF673F0BD3}
  254.  * 
  255.  */
  256. DEFINE_GUID(IID_IHXSetClientContext, 0x9d65e58f, 0x9b4b, 0x40f2, 0x8f, 0xf0, 0x5c, 0xff, 0x67, 0x3f, 0xb, 0xd3);
  257.  
  258. #undef  INTERFACE
  259. #define INTERFACE   IHXSetClientContext
  260. DECLARE_INTERFACE_(IHXSetClientContext, IUnknown)
  261. {
  262.     /*
  263.      * IHXSetClientContext methods
  264.      */
  265.      /************************************************************************
  266.      * Method:
  267.      *     IHXSetClientContext::SetClientContext
  268.      * Purpose:
  269.      *     Called by the client to install itself as the provider of client
  270.      *     services. 
  271.      *
  272.      * Datatype driver client can implement IHXUpgradeCollection in the client context 
  273.      *  to get plugin components upgrade notification.
  274.      *
  275.      *  Can also be used as means for custom source handler to commnuication with client through custom interface
  276.      *  implemnted in the ClientContext.
  277.      */
  278.     STDMETHOD(SetClientContext) (THIS_
  279. IUnknown* pUnknown) PURE;
  280. };
  281. #endif //_HXDTDR_H_