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

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxdllaccess.h,v 1.3.2.4 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 _HXDLLACCESS_H_
  50. #define _HXDLLACCESS_H_
  51. /****************************************************************************
  52.  *  Defines:
  53.  */
  54. /****************************************************************************
  55.  *  DLL types:
  56.  */
  57. #define HXDLLTYPE_NOT_DEFINED 0 // Arbitrary DLLs (no predefined path used)
  58. #define HXDLLTYPE_PLUGIN 1 // Plug-ins
  59. #define HXDLLTYPE_CODEC 2 // Codecs
  60. #define HXDLLTYPE_ENCSDK 3 // Encoder SDK DLLs 
  61. #define HXDLLTYPE_COMMON 4 // Common libraries       
  62. #define HXDLLTYPE_UPDATE 5 // Setup/Upgrade libraries
  63. // HXDLLTYPEs 5-10 are reserved for backward compatibility reasons
  64. /****************************************************************************
  65.  *  Service specific error codes:
  66.  */
  67. #define HXDLL_OK 0
  68. #define HXDLL_NO_LOAD 1
  69. #define HXDLL_BAD_SYMBOL 2
  70. #define HXDLL_OUT_OF_MEMORY 3
  71. /****************************************************************************
  72.  *  Dll default version key
  73.  */
  74. #define HXDLL_DFLT_VERSION 0xFFFFFFFF
  75. /****************************************************************************
  76.  * 
  77.  *  Interface:
  78.  *
  79.  * IHXDllAccess
  80.  *
  81.  *  Purpose:
  82.  *
  83.  * Interface for DLL Access
  84.  *
  85.  *  IID_IHXDllAccess
  86.  *
  87.  * {D5A71AA1-A6ED-479f-9FC6-F06B99142691}
  88.  *
  89.  */
  90. DEFINE_GUID(IID_IHXDllAccess,
  91. 0xd5a71aa1, 0xa6ed, 0x479f, 0x9f, 0xc6, 0xf0, 0x6b, 0x99, 0x14, 0x26, 0x91);
  92. #define CLSID_IHXDllAccess IID_IHXDllAccess
  93. #undef  INTERFACE
  94. #define INTERFACE   IHXDllAccess
  95. DECLARE_INTERFACE_(IHXDllAccess, IUnknown)
  96. {
  97.     /*
  98.      * IUnknown methods
  99.      */
  100.     STDMETHOD(QueryInterface) (THIS_
  101. REFIID riid,
  102. void** ppvObj) PURE;
  103.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  104.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  105.     /*
  106.      * IHXDllAccess methods
  107.      */
  108.     /************************************************************************
  109.      * Method:
  110.      *     IHXDllAccess::Open()
  111.      * Purpose:
  112.      *     Open a Dll of the specified name and type.  
  113.      */
  114.     STDMETHOD(Open) (THIS_
  115. const char* pDllName,
  116. UINT16 uLibType
  117. ) PURE;
  118.     /************************************************************************
  119.      * Method:
  120.      *     IHXDllAccess::Close()
  121.      * Purpose:
  122.      *     Close opened Dll.
  123.      */
  124.     STDMETHOD(Close) (THIS) PURE;
  125.     /************************************************************************
  126.      * Method:
  127.      *     IHXDllAccess::GetSymbol()
  128.      * Purpose:
  129.      *     Obtain pointer to symbol in opened Dll.
  130.      */
  131.     STDMETHOD_(void*, GetSymbol) (THIS_
  132. const char* pSymbolName
  133. ) PURE;
  134.     /************************************************************************
  135.      * Method:
  136.      *     IHXDllAccess::GetError()
  137.      * Purpose:
  138.      *     Get service specific error code (0 = no error).
  139.      */
  140.     STDMETHOD_(ULONG32,GetError) (THIS) PURE;
  141.     /************************************************************************
  142.      * Method:
  143.      *     IHXDllAccess::GetErrorString()
  144.      * Purpose:
  145.      *     Get last error string.
  146.      */
  147.     STDMETHOD_(const char*, GetErrorString) (THIS) PURE;
  148.     /************************************************************************
  149.      * Method:
  150.      *     IHXDllAccess::GetDllName()
  151.      * Purpose:
  152.      *     Get opened Dll name
  153.      */
  154.     STDMETHOD_(const char*, GetDllName) (THIS) PURE;
  155.     /************************************************************************
  156.      * Method:
  157.      *     IHXDllAccess::GetDllVersion()
  158.      * Purpose:
  159.      *     Get opened Dll vesion
  160.      */
  161.     STDMETHOD_(const char*, GetDllVersion) (THIS) PURE;
  162.     
  163.     /************************************************************************
  164.      * Method:
  165.      *     IHXDllAccess::IsOpen()
  166.      * Purpose:
  167.      *     Tells if Dll is opened:
  168.      * TRUE  = dll is opened
  169.      * FALSE = dll is not opened
  170.      */
  171.     STDMETHOD_(BOOL,IsOpen) (THIS) PURE;
  172. };
  173. #include "hxtsmartpointer.h"
  174. HXT_MAKE_SMART_PTR(IHXDllAccess)
  175. #endif  // _HXDLLACCESS_H_