framework/delibs/deutil/deDynamicLibrary.h

   1 #ifndef _DEDYNAMICLIBRARY_H
   2 #define _DEDYNAMICLIBRARY_H
   3 /*-------------------------------------------------------------------------
   4  * drawElements Utility Library
   5  * ----------------------------
   6  *
   7  * Copyright 2014 The Android Open Source Project
   8  *
   9  * Licensed under the Apache License, Version 2.0 (the "License");
  10  * you may not use this file except in compliance with the License.
  11  * You may obtain a copy of the License at
  12  *
  13  *      http://www.apache.org/licenses/LICENSE-2.0
  14  *
  15  * Unless required by applicable law or agreed to in writing, software
  16  * distributed under the License is distributed on an "AS IS" BASIS,
  17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  * See the License for the specific language governing permissions and
  19  * limitations under the License.
  20  *
  21  *//*!
  22  * \file
  23  * \brief Dynamic link library abstraction.
  24  *//*--------------------------------------------------------------------*/
  25
  26 #include "deDefs.h"
  27
  28 DE_BEGIN_EXTERN_C
  29
  30 /* Dynamic link library. */
  31 typedef struct deDynamicLibrary_s deDynamicLibrary;
  32
  33 /*--------------------------------------------------------------------*//*!
  34  * \brief Open dynamic library.
  35  * \param fileName Name or path to dynamic library.
  36  * \return Dynamic library handle, or DE_NULL on failure.
  37  *
  38  * This function opens and loads dynamic library to current process.
  39  * If library is already loaded, its reference count will be increased.
  40  *//*--------------------------------------------------------------------*/
  41 deDynamicLibrary*               deDynamicLibrary_open                   (const char* fileName);
  42
  43 /*--------------------------------------------------------------------*//*!
  44  * \brief Load function symbol from dynamic library.
  45  * \param library Dynamic library
  46  * \param symbolName Name of function symbol
  47  * \return Function pointer or DE_NULL on failure
  48  * \note Returned pointers will be invalidated if dynamic library is
  49  *       unloaded.
  50  *//*--------------------------------------------------------------------*/
  51 deFunctionPtr                   deDynamicLibrary_getFunction    (const deDynamicLibrary* library, const char* symbolName);
  52
  53 /*--------------------------------------------------------------------*//*!
  54  * \brief Close dynamic library.
  55  * \param library Dynamic library
  56  *
  57  * Closing library handle decrements reference count. Library is unloaded
  58  * from process if reference count reaches zero.
  59  *//*--------------------------------------------------------------------*/
  60 void                                    deDynamicLibrary_close                  (deDynamicLibrary* library);
  61
  62 DE_END_EXTERN_C
  63
  64 #endif /* _DEDYNAMICLIBRARY_H */