cinvoke.h

Go to the documentation of this file.

/*
C/Invoke Source Code File

Copyright (c) 2006 Will Weisser

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

   1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
   2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
   3. The name of the author may not be used to endorse or promote products
derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef _CINVOKE_H
#define _CINVOKE_H

#include "cinvoke-arch.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct _CInvLibrary {
        ArchLibrary arch;
} CInvLibrary;

typedef struct _CInvFunction {
        cinv_callconv_t callconv;
        int hasreturn;
        cinv_type_t rettype;
        int numparms;
        int *parmstacksizes;
        int *parmalignments;
        int *parmmemsizes;
        cinv_type_t *parmtypes;
        short stacksize;
} CInvFunction;

typedef void (*cinv_cbfunc_t)(CInvFunction *f, void *parameters[],
        void *returnout, void *userdata);

struct _CInvStructure;
struct hashtable;

typedef struct _CInvStructMember {
        struct _CInvStructure *structtype;
        cinv_type_t type;
        int offset;
        int alignment;
} CInvStructMember;

typedef struct _CInvStructure {
        struct hashtable *members;
        CInvStructMember *firstmember;
        int nextoffset;
        int finished;
} CInvStructure;

typedef struct _CInvCallback {
        CInvFunction *prototype;
        void *userdata;
        cinv_cbfunc_t cbfunc;
        char *stub;
} CInvCallback;

// public functions

CInvContext *cinv_context_create();
const char *cinv_context_geterrormsg(CInvContext *context);
cinv_int32_t cinv_context_geterrorcode(CInvContext *context);
cinv_status_t cinv_context_delete(CInvContext *context);

CInvLibrary *cinv_library_create(CInvContext *context, const char *path);
void *cinv_library_load_entrypoint(CInvContext *context,
        CInvLibrary *library, const char *name);
cinv_status_t cinv_library_delete(CInvContext *context, CInvLibrary *library);

CInvFunction *cinv_function_create(CInvContext *context,
        cinv_callconv_t callingconvention, const char *returnformat,
        const char *parameterformat);
cinv_status_t cinv_function_invoke(CInvContext *context,
        CInvFunction *function, void *entrypoint, void *returnvalout,
        void *parameters[]);
cinv_status_t cinv_function_delete(CInvContext *context,
        CInvFunction *function);

CInvStructure *cinv_structure_create(CInvContext *context);
cinv_status_t cinv_structure_addmember_value(CInvContext *context,
        CInvStructure *structure, const char *name, cinv_type_t type);
cinv_status_t cinv_structure_addmember_struct(CInvContext *context,
        CInvStructure *structure, const char *name, CInvStructure *type);
cinv_status_t cinv_structure_finish(CInvContext *context,
        CInvStructure *structure);
cinv_status_t cinv_structure_getsize(CInvContext *context,
        CInvStructure *structure, int *size_out);
void *cinv_structure_create_instance(CInvContext *context,
        CInvStructure *structure);
cinv_status_t cinv_structure_instance_setvalue(CInvContext *context,
        CInvStructure *structure, void *instance, const char *name,
        void *value_ptr);
void *cinv_structure_instance_getvalue(CInvContext *context,
        CInvStructure *structure, void *instance, const char *name);
cinv_status_t cinv_structure_delete_instance(CInvContext *context,
        void *instance);
cinv_status_t cinv_structure_delete(CInvContext *context,
        CInvStructure *structure);

CInvCallback *cinv_callback_create(CInvContext *context,
        CInvFunction *prototype, void *userdata, cinv_cbfunc_t cbfunc);
void *cinv_callback_getentrypoint(CInvContext *context,
        CInvCallback *callback);
cinv_status_t cinv_callback_delete(CInvContext *context,
        CInvCallback *callback);
#ifdef __cplusplus
}
#endif

#endif

---