Click here to Skip to main content
15,868,016 members
Articles / Programming Languages / C#
Article

Calling methods from Dll compiled in 'C' from C#

Rate me:
Please Sign up or sign in to vote.
2.84/5 (17 votes)
1 May 20044 min read 160.3K   31   8
Describes how to interface 'C' code with C# through Dlls compiled in 'C'

There a few examples out there on how to call Win32 methods from user.dll in C# for example but I didn’t find any articles that dealt explicitly with creating a DLL in straight ‘C’ then importing the methods in the ‘C’ dll from C#.

<o:p> 

This begs the obvious question: why would you want to write a Dll in ‘C’ in the first place?

<o:p> 

Well, in my case (I’ll try to keep the story short) I have a fifteen year old ISA card that supports eight electronic relays. These relays can switch electronic appliances on or off from computer control through the IO bus. This is where the fun begins because you cannot simply use the ANSI ‘C’ method outportb() to send a value out directly to an IO port while running various flavors of XP like you could do in the past with old versions of Windows where all processes shared the same memory heap (thus causing all of those fun access violations).

<o:p> 

I found a ready made device driver written in ‘C’ that allows a process access to IO ports in XP but in order to make a call outportb() from C#,  still required that I write an ‘adaptor’ .Dll in ‘C’.

<o:p> 

I knew how to use the [DllImport()] attribute when importing native Win32 methods from user.dll etc. but I found that that very technique did not work with the Dll that I had written myself in ‘C’.

<o:p> 

The first problem was that the C# compiler kept throwing an error that said “Unable to find an entry point named OpenIO in DLL PortIO.dll. After looking carefully at the method signature in OpenIO – I could find nothing wrong but then I remembered that there was something you had to do with a .DEF file or something. I scoured with Google searches where I found bits and pieces but no articles that addressed my problem explicitly.

<o:p> 

In summary here are the lessons learned (some re-learned):

<o:p> 

-         When using the .Net compiler (or the VC6 compiler as well) with a ‘C’ project where the source file extension is *.cpp – you must either turn name mangling off by enclosing your public (__declspec(dllexport) = public in ‘C’) methods in a block defined as ‘extern “C”’ or use a .DEF file. I chose to use ‘extern “C”’. Name mangling is how C++ compilers distinguish overloaded methods with the same name. Note that you cannot overload any methods enclosed in ‘extern “C”. I believe with VC6 you can turn off mangling by simply changing the source extension to *.c but I have not tried this with VS.Net.<o:p>

-         You can import mangled or any other public method by using the EntryPoint parameter for DllImport which will take either an ordinal index or the method name. I use both method name and ordinal position in the sample code to illustrate this point.<o:p>

-         Dumpbin.exe which comes with VS.Net is indispensable when troubleshooting Dlls written in ‘C’. An example of how to use this and sample output is in the comments of the source code.<o:p>

-         If you do not include the modifier __declspec(dllexport) in your ‘C’ Dll function definition (prototype in header [.h] file) and declaration (function body in *.c or *.cpp file) the method will not be exported as ‘public’ and the entry point will not show up in the binary dump of the Dll.

<o:p> 

<o:p>Here's an example of a properly defined native Dll method written in 'C':

<o:p> 

<o:p>

extern "C" <o:p>

{<o:p>

//Note: must use __declspec(dllexport) to make (export) methods as 'public'<o:p>

      __declspec(dllexport) void DoSomethingInC(unsigned short int ExampleParam, unsigned char AnotherExampleParam)<o:p>

      {<o:p>

            printf("You called method DoSomethingInC(), You passed in %d and %c\n\r", ExampleParam, AnotherExampleParam);<o:p>

      }<o:p>

}//End 'extern "C"' to prevent name mangling<o:p>

 

 Here's what the import declaration in C# looks like:

[DllImport("C_DLL_with_Csharp.dll", EntryPoint="DoSomethingInC")]

public static extern void DoSomethingInC(ushort ExampleParam, char AnotherExampleParam);

Here's what the Dll dump looks like:

File Type: DLL

Section contains the following exports for C_DLL_with_Csharp.dll

00000000 characteristics

409557E6 time date stamp Sun May 02 13:19:50 2004

0.00 version

1 ordinal base

2 number of functions

2 number of names

ordinal hint RVA name

1 0 00011596 ?DoSomethingInMangledC@@YAXPAD@Z

2 1 0001110E DoSomethingInC

Summary

4000 .data

1000 .idata

5000 .rdata

2000 .reloc

1F000 .text

10000 .textbss

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer (Senior) Experior Technologies
United States United States
www.thorskettle.com

Comments and Discussions

 
Generalchar* names[] Pin
kobybr23-Aug-04 10:22
kobybr23-Aug-04 10:22 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.