Merge pull request #2202 from mono/revert-2090-mono-4.2.0-branch-bug25480
[mono-project.git] / mono / metadata / marshal.h
blob38a7a5c20e2862a83ab8a3abebe8519749735060
2 /*
3 * marshal.h: Routines for marshaling complex types in P/Invoke methods.
4 *
5 * Author:
6 * Paolo Molaro (lupus@ximian.com)
8 * (C) 2002 Ximian, Inc. http://www.ximian.com
12 #ifndef __MONO_MARSHAL_H__
13 #define __MONO_MARSHAL_H__
15 #include <mono/metadata/class.h>
16 #include <mono/metadata/object-internals.h>
17 #include <mono/metadata/class-internals.h>
18 #include <mono/metadata/opcodes.h>
19 #include <mono/metadata/reflection.h>
20 #include <mono/metadata/method-builder.h>
21 #include <mono/metadata/remoting.h>
23 #define mono_marshal_find_bitfield_offset(type, elem, byte_offset, bitmask) \
24 do { \
25 type tmp; \
26 memset (&tmp, 0, sizeof (tmp)); \
27 tmp.elem = 1; \
28 mono_marshal_find_nonzero_bit_offset ((guint8*)&tmp, sizeof (tmp), (byte_offset), (bitmask)); \
29 } while (0)
32 * This structure holds the state kept by the emit_ marshalling functions.
33 * This is exported so it can be used by cominterop.c.
35 typedef struct {
36 MonoMethodBuilder *mb;
37 MonoMethodSignature *sig;
38 MonoMethodPInvoke *piinfo;
39 int *orig_conv_args; /* Locals containing the original values of byref args */
40 int retobj_var;
41 MonoClass *retobj_class;
42 MonoMethodSignature *csig; /* Might need to be changed due to MarshalAs directives */
43 MonoImage *image; /* The image to use for looking up custom marshallers */
44 } EmitMarshalContext;
46 typedef enum {
48 * This is invoked to convert arguments from the current types to
49 * the underlying types expected by the platform routine. If required,
50 * the methods create a temporary variable with the proper type, and return
51 * the location for it (either the passed argument, or the newly allocated
52 * local slot).
54 MARSHAL_ACTION_CONV_IN,
57 * This operation is called to push the actual value that was optionally
58 * converted on the first stage
60 MARSHAL_ACTION_PUSH,
63 * Convert byref arguments back or free resources allocated during the
64 * CONV_IN stage
66 MARSHAL_ACTION_CONV_OUT,
69 * The result from the unmanaged call is at the top of the stack when
70 * this action is invoked. The result should be stored in the
71 * third local variable slot.
73 MARSHAL_ACTION_CONV_RESULT,
75 MARSHAL_ACTION_MANAGED_CONV_IN,
76 MARSHAL_ACTION_MANAGED_CONV_OUT,
77 MARSHAL_ACTION_MANAGED_CONV_RESULT
78 } MarshalAction;
81 * This is an extension of the MONO_WRAPPER_ enum to avoid adding more elements to that
82 * enum.
84 typedef enum {
85 WRAPPER_SUBTYPE_NONE,
86 /* Subtypes of MONO_WRAPPER_MANAGED_TO_MANAGED */
87 WRAPPER_SUBTYPE_ELEMENT_ADDR,
88 WRAPPER_SUBTYPE_STRING_CTOR,
89 /* Subtypes of MONO_WRAPPER_STELEMREF */
90 WRAPPER_SUBTYPE_VIRTUAL_STELEMREF,
91 /* Subtypes of MONO_WRAPPER_UNKNOWN */
92 WRAPPER_SUBTYPE_FAST_MONITOR_ENTER,
93 WRAPPER_SUBTYPE_FAST_MONITOR_ENTER_V4,
94 WRAPPER_SUBTYPE_FAST_MONITOR_EXIT,
95 WRAPPER_SUBTYPE_PTR_TO_STRUCTURE,
96 WRAPPER_SUBTYPE_STRUCTURE_TO_PTR,
97 /* Subtypes of MONO_WRAPPER_CASTCLASS */
98 WRAPPER_SUBTYPE_CASTCLASS_WITH_CACHE,
99 WRAPPER_SUBTYPE_ISINST_WITH_CACHE,
100 /* Subtypes of MONO_WRAPPER_RUNTIME_INVOKE */
101 WRAPPER_SUBTYPE_RUNTIME_INVOKE_NORMAL,
102 WRAPPER_SUBTYPE_RUNTIME_INVOKE_DYNAMIC,
103 WRAPPER_SUBTYPE_RUNTIME_INVOKE_DIRECT,
104 WRAPPER_SUBTYPE_RUNTIME_INVOKE_VIRTUAL,
105 /* Subtypes of MONO_WRAPPER_MANAGED_TO_NATIVE */
106 WRAPPER_SUBTYPE_ICALL_WRAPPER,
107 WRAPPER_SUBTYPE_NATIVE_FUNC_AOT,
108 WRAPPER_SUBTYPE_PINVOKE,
109 /* Subtypes of MONO_WRAPPER_UNKNOWN */
110 WRAPPER_SUBTYPE_SYNCHRONIZED_INNER,
111 WRAPPER_SUBTYPE_GSHAREDVT_IN,
112 WRAPPER_SUBTYPE_GSHAREDVT_OUT,
113 WRAPPER_SUBTYPE_ARRAY_ACCESSOR,
114 /* Subtypes of MONO_WRAPPER_MANAGED_TO_MANAGED */
115 WRAPPER_SUBTYPE_GENERIC_ARRAY_HELPER,
116 /* Subtypes of MONO_WRAPPER_DELEGATE_INVOKE */
117 WRAPPER_SUBTYPE_DELEGATE_INVOKE_VIRTUAL,
118 WRAPPER_SUBTYPE_DELEGATE_INVOKE_BOUND
119 } WrapperSubtype;
121 typedef struct {
122 MonoMethod *method;
123 MonoClass *klass;
124 } NativeToManagedWrapperInfo;
126 typedef struct {
127 MonoMethod *method;
128 } StringCtorWrapperInfo;
130 typedef struct {
131 int kind;
132 } VirtualStelemrefWrapperInfo;
134 typedef struct {
135 guint32 rank, elem_size;
136 } ElementAddrWrapperInfo;
138 typedef struct {
139 MonoMethod *method;
140 /* For WRAPPER_SUBTYPE_RUNTIME_INVOKE_NORMAL */
141 MonoMethodSignature *sig;
142 } RuntimeInvokeWrapperInfo;
144 typedef struct {
145 MonoMethod *method;
146 } ManagedToNativeWrapperInfo;
148 typedef struct {
149 MonoMethod *method;
150 } SynchronizedInnerWrapperInfo;
152 typedef struct {
153 MonoMethod *method;
154 } GenericArrayHelperWrapperInfo;
156 typedef struct {
157 gpointer func;
158 } ICallWrapperInfo;
160 typedef struct {
161 MonoMethod *method;
162 } ArrayAccessorWrapperInfo;
164 typedef struct {
165 MonoClass *klass;
166 } ProxyWrapperInfo;
169 * This structure contains additional information to uniquely identify a given wrapper
170 * method. It can be retrieved by mono_marshal_get_wrapper_info () for certain types
171 * of wrappers, i.e. ones which do not have a 1-1 association with a method/class.
173 typedef struct {
174 WrapperSubtype subtype;
175 union {
176 /* RUNTIME_INVOKE_... */
177 RuntimeInvokeWrapperInfo runtime_invoke;
178 /* STRING_CTOR */
179 StringCtorWrapperInfo string_ctor;
180 /* ELEMENT_ADDR */
181 ElementAddrWrapperInfo element_addr;
182 /* VIRTUAL_STELEMREF */
183 VirtualStelemrefWrapperInfo virtual_stelemref;
184 /* MONO_WRAPPER_NATIVE_TO_MANAGED */
185 NativeToManagedWrapperInfo native_to_managed;
186 /* MONO_WRAPPER_MANAGED_TO_NATIVE */
187 ManagedToNativeWrapperInfo managed_to_native;
188 /* SYNCHRONIZED_INNER */
189 SynchronizedInnerWrapperInfo synchronized_inner;
190 /* GENERIC_ARRAY_HELPER */
191 GenericArrayHelperWrapperInfo generic_array_helper;
192 /* ICALL_WRAPPER */
193 ICallWrapperInfo icall;
194 /* ARRAY_ACCESSOR */
195 ArrayAccessorWrapperInfo array_accessor;
196 /* PROXY_ISINST etc. */
197 ProxyWrapperInfo proxy;
198 } d;
199 } WrapperInfo;
201 G_BEGIN_DECLS
203 /*type of the function pointer of methods returned by mono_marshal_get_runtime_invoke*/
204 typedef MonoObject *(*RuntimeInvokeFunction) (MonoObject *this_obj, void **params, MonoObject **exc, void* compiled_method);
206 typedef void (*RuntimeInvokeDynamicFunction) (void *args, MonoObject **exc, void* compiled_method);
208 /* marshaling helper functions */
210 void
211 mono_marshal_init (void);
213 void
214 mono_marshal_init_tls (void);
216 void
217 mono_marshal_cleanup (void);
219 gint32
220 mono_class_native_size (MonoClass *klass, guint32 *align);
222 MonoMarshalType *
223 mono_marshal_load_type_info (MonoClass* klass);
225 gint32
226 mono_marshal_type_size (MonoType *type, MonoMarshalSpec *mspec, guint32 *align,
227 gboolean as_field, gboolean unicode);
229 int
230 mono_type_native_stack_size (MonoType *type, guint32 *alignment);
232 gpointer
233 mono_array_to_savearray (MonoArray *array);
235 gpointer
236 mono_array_to_lparray (MonoArray *array);
238 void
239 mono_free_lparray (MonoArray *array, gpointer* nativeArray);
241 void
242 mono_string_utf8_to_builder (MonoStringBuilder *sb, char *text);
244 void
245 mono_string_utf16_to_builder (MonoStringBuilder *sb, gunichar2 *text);
247 gchar*
248 mono_string_builder_to_utf8 (MonoStringBuilder *sb);
250 gunichar2*
251 mono_string_builder_to_utf16 (MonoStringBuilder *sb);
253 gpointer
254 mono_string_to_ansibstr (MonoString *string_obj);
256 gpointer
257 mono_string_to_bstr (MonoString *string_obj);
259 void
260 mono_string_to_byvalstr (gpointer dst, MonoString *src, int size);
262 void
263 mono_string_to_byvalwstr (gpointer dst, MonoString *src, int size);
265 gpointer
266 mono_delegate_to_ftnptr (MonoDelegate *delegate);
268 MonoDelegate*
269 mono_ftnptr_to_delegate (MonoClass *klass, gpointer ftn);
271 void mono_delegate_free_ftnptr (MonoDelegate *delegate);
273 void
274 mono_marshal_set_last_error (void);
276 gpointer
277 mono_marshal_asany (MonoObject *obj, MonoMarshalNative string_encoding, int param_attrs);
279 void
280 mono_marshal_free_asany (MonoObject *o, gpointer ptr, MonoMarshalNative string_encoding, int param_attrs);
282 guint
283 mono_type_to_ldind (MonoType *type);
285 guint
286 mono_type_to_stind (MonoType *type);
288 /* functions to create various architecture independent helper functions */
290 MonoMethod *
291 mono_marshal_method_from_wrapper (MonoMethod *wrapper);
293 WrapperInfo*
294 mono_wrapper_info_create (MonoMethodBuilder *mb, WrapperSubtype subtype);
296 void
297 mono_marshal_set_wrapper_info (MonoMethod *method, gpointer data);
299 gpointer
300 mono_marshal_get_wrapper_info (MonoMethod *wrapper);
302 MonoMethod *
303 mono_marshal_get_delegate_begin_invoke (MonoMethod *method);
305 MonoMethod *
306 mono_marshal_get_delegate_end_invoke (MonoMethod *method);
308 MonoMethod *
309 mono_marshal_get_delegate_invoke (MonoMethod *method, MonoDelegate *del);
311 MonoMethod *
312 mono_marshal_get_delegate_invoke_internal (MonoMethod *method, gboolean callvirt, gboolean static_method_with_first_arg_bound, MonoMethod *target_method);
314 MonoMethod *
315 mono_marshal_get_runtime_invoke (MonoMethod *method, gboolean is_virtual);
317 MonoMethod*
318 mono_marshal_get_runtime_invoke_dynamic (void);
320 MonoMethodSignature*
321 mono_marshal_get_string_ctor_signature (MonoMethod *method);
323 MonoMethod *
324 mono_marshal_get_managed_wrapper (MonoMethod *method, MonoClass *delegate_klass, uint32_t this_loc);
326 gpointer
327 mono_marshal_get_vtfixup_ftnptr (MonoImage *image, guint32 token, guint16 type);
329 MonoMethod *
330 mono_marshal_get_icall_wrapper (MonoMethodSignature *sig, const char *name, gconstpointer func, gboolean check_exceptions);
332 MonoMethod *
333 mono_marshal_get_native_wrapper (MonoMethod *method, gboolean check_exceptions, gboolean aot);
335 MonoMethod *
336 mono_marshal_get_native_func_wrapper (MonoImage *image, MonoMethodSignature *sig, MonoMethodPInvoke *piinfo, MonoMarshalSpec **mspecs, gpointer func);
338 MonoMethod*
339 mono_marshal_get_native_func_wrapper_aot (MonoClass *klass);
341 MonoMethod *
342 mono_marshal_get_struct_to_ptr (MonoClass *klass);
344 MonoMethod *
345 mono_marshal_get_ptr_to_struct (MonoClass *klass);
347 MonoMethod *
348 mono_marshal_get_synchronized_wrapper (MonoMethod *method);
350 MonoMethod *
351 mono_marshal_get_synchronized_inner_wrapper (MonoMethod *method);
353 MonoMethod *
354 mono_marshal_get_unbox_wrapper (MonoMethod *method);
356 MonoMethod *
357 mono_marshal_get_castclass_with_cache (void);
359 MonoMethod *
360 mono_marshal_get_isinst_with_cache (void);
362 MonoMethod *
363 mono_marshal_get_isinst (MonoClass *klass);
365 MonoMethod *
366 mono_marshal_get_castclass (MonoClass *klass);
368 MonoMethod *
369 mono_marshal_get_stelemref (void);
371 MonoMethod*
372 mono_marshal_get_virtual_stelemref (MonoClass *array_class);
374 MonoMethod**
375 mono_marshal_get_virtual_stelemref_wrappers (int *nwrappers);
377 MonoMethod*
378 mono_marshal_get_array_address (int rank, int elem_size);
380 MonoMethod *
381 mono_marshal_get_array_accessor_wrapper (MonoMethod *method);
383 MonoMethod *
384 mono_marshal_get_generic_array_helper (MonoClass *klass, MonoClass *iface,
385 gchar *name, MonoMethod *method);
387 MonoMethod *
388 mono_marshal_get_thunk_invoke_wrapper (MonoMethod *method);
390 MonoMethod*
391 mono_marshal_get_gsharedvt_in_wrapper (void);
393 MonoMethod*
394 mono_marshal_get_gsharedvt_out_wrapper (void);
396 void
397 mono_marshal_free_dynamic_wrappers (MonoMethod *method);
399 void
400 mono_marshal_free_inflated_wrappers (MonoMethod *method);
402 void
403 mono_marshal_lock_internal (void);
405 void
406 mono_marshal_unlock_internal (void);
408 /* marshaling internal calls */
410 void *
411 mono_marshal_alloc (gulong size);
413 void
414 mono_marshal_free (gpointer ptr);
416 void
417 mono_marshal_free_array (gpointer *ptr, int size);
419 gboolean
420 mono_marshal_free_ccw (MonoObject* obj);
422 void
423 cominterop_release_all_rcws (void);
425 void
426 ves_icall_System_Runtime_InteropServices_Marshal_copy_to_unmanaged (MonoArray *src, gint32 start_index,
427 gpointer dest, gint32 length);
429 void
430 ves_icall_System_Runtime_InteropServices_Marshal_copy_from_unmanaged (gpointer src, gint32 start_index,
431 MonoArray *dest, gint32 length);
433 MonoString *
434 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStringAnsi (char *ptr);
436 MonoString *
437 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStringAnsi_len (char *ptr, gint32 len);
439 MonoString *
440 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStringUni (guint16 *ptr);
442 MonoString *
443 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStringUni_len (guint16 *ptr, gint32 len);
445 MonoString *
446 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStringBSTR (gpointer ptr);
448 guint32
449 ves_icall_System_Runtime_InteropServices_Marshal_GetComSlotForMethodInfoInternal (MonoReflectionMethod *m);
451 guint32
452 ves_icall_System_Runtime_InteropServices_Marshal_GetLastWin32Error (void);
454 guint32
455 ves_icall_System_Runtime_InteropServices_Marshal_SizeOf (MonoReflectionType *rtype);
457 void
458 ves_icall_System_Runtime_InteropServices_Marshal_StructureToPtr (MonoObject *obj, gpointer dst, MonoBoolean delete_old);
460 void
461 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStructure (gpointer src, MonoObject *dst);
463 MonoObject *
464 ves_icall_System_Runtime_InteropServices_Marshal_PtrToStructure_type (gpointer src, MonoReflectionType *type);
467 ves_icall_System_Runtime_InteropServices_Marshal_OffsetOf (MonoReflectionType *type, MonoString *field_name);
469 gpointer
470 ves_icall_System_Runtime_InteropServices_Marshal_StringToBSTR (MonoString *string);
472 gpointer
473 ves_icall_System_Runtime_InteropServices_Marshal_StringToHGlobalAnsi (MonoString *string);
475 gpointer
476 ves_icall_System_Runtime_InteropServices_Marshal_StringToHGlobalUni (MonoString *string);
478 void
479 ves_icall_System_Runtime_InteropServices_Marshal_DestroyStructure (gpointer src, MonoReflectionType *type);
481 void*
482 ves_icall_System_Runtime_InteropServices_Marshal_AllocCoTaskMem (int size);
484 void
485 ves_icall_System_Runtime_InteropServices_Marshal_FreeCoTaskMem (void *ptr);
487 gpointer
488 ves_icall_System_Runtime_InteropServices_Marshal_ReAllocCoTaskMem (gpointer ptr, int size);
490 void*
491 ves_icall_System_Runtime_InteropServices_Marshal_AllocHGlobal (int size);
493 gpointer
494 ves_icall_System_Runtime_InteropServices_Marshal_ReAllocHGlobal (gpointer ptr, int size);
496 void
497 ves_icall_System_Runtime_InteropServices_Marshal_FreeHGlobal (void *ptr);
499 void
500 ves_icall_System_Runtime_InteropServices_Marshal_FreeBSTR (void *ptr);
502 void*
503 ves_icall_System_Runtime_InteropServices_Marshal_UnsafeAddrOfPinnedArrayElement (MonoArray *arrayobj, int index);
505 MonoDelegate*
506 ves_icall_System_Runtime_InteropServices_Marshal_GetDelegateForFunctionPointerInternal (void *ftn, MonoReflectionType *type);
509 ves_icall_System_Runtime_InteropServices_Marshal_AddRefInternal (gpointer pUnk);
512 ves_icall_System_Runtime_InteropServices_Marshal_QueryInterfaceInternal (gpointer pUnk, gpointer riid, gpointer* ppv);
515 ves_icall_System_Runtime_InteropServices_Marshal_ReleaseInternal (gpointer pUnk);
517 void*
518 ves_icall_System_Runtime_InteropServices_Marshal_GetIUnknownForObjectInternal (MonoObject* object);
520 MonoObject*
521 ves_icall_System_Runtime_InteropServices_Marshal_GetObjectForCCW (void* pUnk);
523 void*
524 ves_icall_System_Runtime_InteropServices_Marshal_GetIDispatchForObjectInternal (MonoObject* object);
526 void*
527 ves_icall_System_Runtime_InteropServices_Marshal_GetCCW (MonoObject* object, MonoReflectionType* type);
529 MonoBoolean
530 ves_icall_System_Runtime_InteropServices_Marshal_IsComObject (MonoObject* object);
532 gint32
533 ves_icall_System_Runtime_InteropServices_Marshal_ReleaseComObjectInternal (MonoObject* object);
535 MonoObject *
536 ves_icall_System_ComObject_CreateRCW (MonoReflectionType *type);
538 void
539 ves_icall_System_ComObject_ReleaseInterfaces(MonoComObject* obj);
541 gpointer
542 ves_icall_System_ComObject_GetInterfaceInternal (MonoComObject* obj, MonoReflectionType* type, MonoBoolean throw_exception);
544 void
545 ves_icall_Mono_Interop_ComInteropProxy_AddProxy (gpointer pUnk, MonoComInteropProxy* proxy);
547 MonoComInteropProxy*
548 ves_icall_Mono_Interop_ComInteropProxy_FindProxy (gpointer pUnk);
550 MONO_API void
551 mono_win32_compat_CopyMemory (gpointer dest, gconstpointer source, gsize length);
553 MONO_API void
554 mono_win32_compat_FillMemory (gpointer dest, gsize length, guchar fill);
556 MONO_API void
557 mono_win32_compat_MoveMemory (gpointer dest, gconstpointer source, gsize length);
559 MONO_API void
560 mono_win32_compat_ZeroMemory (gpointer dest, gsize length);
562 void
563 mono_marshal_find_nonzero_bit_offset (guint8 *buf, int len, int *byte_offset, guint8 *bitmask) MONO_LLVM_INTERNAL;
565 MonoMethodSignature*
566 mono_signature_no_pinvoke (MonoMethod *method);
568 /* Called from cominterop.c/remoting.c */
570 void
571 mono_marshal_emit_native_wrapper (MonoImage *image, MonoMethodBuilder *mb, MonoMethodSignature *sig, MonoMethodPInvoke *piinfo, MonoMarshalSpec **mspecs, gpointer func, gboolean aot, gboolean check_exceptions, gboolean func_param);
573 void
574 mono_marshal_emit_managed_wrapper (MonoMethodBuilder *mb, MonoMethodSignature *invoke_sig, MonoMarshalSpec **mspecs, EmitMarshalContext* m, MonoMethod *method, uint32_t target_handle);
576 GHashTable*
577 mono_marshal_get_cache (GHashTable **var, GHashFunc hash_func, GCompareFunc equal_func);
579 MonoMethod*
580 mono_marshal_find_in_cache (GHashTable *cache, gpointer key);
582 MonoMethod*
583 mono_mb_create_and_cache (GHashTable *cache, gpointer key,
584 MonoMethodBuilder *mb, MonoMethodSignature *sig,
585 int max_stack);
586 void
587 mono_marshal_emit_thread_interrupt_checkpoint (MonoMethodBuilder *mb);
589 void
590 mono_marshal_emit_thread_force_interrupt_checkpoint (MonoMethodBuilder *mb);
592 void
593 mono_marshal_use_aot_wrappers (gboolean use);
595 MonoObject *
596 mono_marshal_xdomain_copy_value (MonoObject *val);
599 mono_mb_emit_save_args (MonoMethodBuilder *mb, MonoMethodSignature *sig, gboolean save_this);
601 void
602 mono_mb_emit_restore_result (MonoMethodBuilder *mb, MonoType *return_type);
604 MonoMethod*
605 mono_mb_create (MonoMethodBuilder *mb, MonoMethodSignature *sig,
606 int max_stack, WrapperInfo *info);
608 MonoMethod*
609 mono_mb_create_and_cache_full (GHashTable *cache, gpointer key,
610 MonoMethodBuilder *mb, MonoMethodSignature *sig,
611 int max_stack, WrapperInfo *info, gboolean *out_found);
613 G_END_DECLS
615 #endif /* __MONO_MARSHAL_H__ */