Passing Structures to Unmanaged Code

**Pavel Minaev** · Jul 15 '08, 02:55 PM

Re: Passing Structures to Unmanaged Code

On Jul 15, 1:20 pm, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

I am attempting to write a .NET wrapper in C# for an SDK that has been
supplied as a .LIB file and a .h header file. I have got most of the
functions to work but am really struggling with the functions that require a
structure to be passed to them. The function declaration in the .h file is
of the form:
SDCERR GetConfig(char *name, SDCConfig *cfg);
where SDCConfig is a structure defined in the .h file. I am not much of aC
(or C#) programmer but does the * in front of the cfg signify that the
structure has to be passed using the ref keyword (by reference)?

Yes.

The other part I am having trouble with is the definition of the actual
structure itself. The .h definition is:
typedef struct _SDCConfig {
char configName[CONFIG_NAME_SZ];
char SSID[SSID_SZ];
int txPower;
....
....
CRYPT WEPKeys;} SDCConfig;
>
(where CRYPT is another structure containing a char array). Whatever I seem
to try in the C# definition, I am getting a NotSupportedExc eption when
calling the function. I am attempting to use the MarshalAs keyword in front
of the char array definitions, which I have done successfully when passing
strings, but to be honest I don't really understand what I am doing! I also
have another structure containing DWORDs as well as char arrays that I don't
know what to do with. The code I am using is:
[StructLayout.(L ayoutKind.Seque ntial, CharSet = CharSet.Unicode )]
public struct SDCConfig
{
MarshalAs[UnmanagedType.L PArray, SizeConst=CONFI G_NAME_SZ];
public byte[] configName;
...
...
}

Are you sure the NotSupportedExc eption is because of [MarshalAs]?

Anyway, it would be helpful if you gave the entire definition of the
struct, both the original C, and your C# version. Also, C# DllImport
declaration for the function would be handy, too.

**Andy Baker** · Jul 15 '08, 03:35 PM

Re: Passing Structures to Unmanaged Code

Thanks for getting back to me on this.

>Are you sure the NotSupportedExc eption is because of [MarshalAs]?

No, it could be anything I guess!

>Anyway, it would be helpful if you gave the entire definition of the
>struct, both the original C, and your C# version. Also, C# DllImport
>declaration for the function would be handy, too.

They are as follows:
C .h header file - Structures

typedef struct _CRYPT {
DWORD size;
char buffer [120];
DWORD offset;
} CRYPT;

typedef struct _SDCConfig {
char configName[CONFIG_NAME_SZ];
char SSID[SSID_SZ];
char clientName[CLIENT_NAME_SZ];
int txPower;
AUTH authType;
EAPTYPE eapType;
POWERSAVE powerSave;
WEPTYPE wepType;
BITRATE bitRate;
RADIOMODE radioMode;
CRYPT userName;
CRYPT userPwd;
CRYPT PSK;
CRYPT WEPKeys;
} SDCConfig

And the declaration for one of the functions is
SDCERR GetConfig(char *name, SDCCONFIG *cfg);

My C# code - Structures

[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct CRYPT
{
public uint size;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = 120)]
public string buffer;
public uint offset;
}

[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct SDCConfig
{
[MarshalAs(Unman agedType.ByValT Str, SizeConst = CONFIG_NAME_SZ)]
public string configName;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = SSID_SZ)]
public string SSID;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = CLIENT_NAME_SZ)]
public string clientName;
public Int32 txPower;
public AUTH authType;
public EAPTYPE eapType;
public POWERSAVE powerSave;
public WEPTYPE wepType;
public BITRATE bitRate;
public RADIOMODE radioMode;
public CRYPT userName;
public CRYPT userPwd;
public CRYPT PSK;
public CRYPT WEPKeys;
}

[DllImport("VPSu mmit.dll", CharSet = CharSet.Unicode )]
public static extern SDCERR GetConfig([MarshalAs(Unman aged.Type.LPArr ay)]
byte [] name, ref SDCCONFIG cfg)];

and the function call is:
public bool ConfigTest
{
string configName = "VANPUTER";
byte [] Name = System.Text.ASC IIEncoding.ASCI I.GetBytes(Conf igName +
'\0');
SDCConfig cfg = new SDCConfig();
SDCERR result = GetConfig(Name, cfg);
return (result = SDCERR_SUCCESS) ;
}

Actually this particular function does not give me a NotSupportedExc eption,
and result contains SDCERR_SUCCESS, but cfg does not contain the
configuration values that it should, so I am obviously doing something
wrong. The other types SDCCERR, AUTH, EAPTYPE etc are defined as enums in
both C and C# and CONFIG_NAME_SZ etc are constant values. I am well out of
my depth here, so any advice will be very welcome! Thanks.

Andy Baker

**Pavel Minaev** · Jul 15 '08, 04:55 PM

Re: Passing Structures to Unmanaged Code

On Jul 15, 7:33 pm, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

Thanks for getting back to me on this.
>

Are you sure the NotSupportedExc eption is because of [MarshalAs]?

>
No, it could be anything I guess!
>

Anyway, it would be helpful if you gave the entire definition of the
struct, both the original C, and your C# version. Also, C# DllImport
declaration for the function would be handy, too.

>
They are as follows:
C .h header file - Structures
>
typedef struct _CRYPT {
DWORD size;
char buffer [120];
DWORD offset;
>
} CRYPT;
>
typedef struct _SDCConfig {
char configName[CONFIG_NAME_SZ];
char SSID[SSID_SZ];
char clientName[CLIENT_NAME_SZ];
int txPower;
AUTH authType;
EAPTYPE eapType;
POWERSAVE powerSave;
WEPTYPE wepType;
BITRATE bitRate;
RADIOMODE radioMode;
CRYPT userName;
CRYPT userPwd;
CRYPT PSK;
CRYPT WEPKeys;
>
} SDCConfig
>
And the declaration for one of the functions is
SDCERR GetConfig(char *name, SDCCONFIG *cfg);
>
My C# code - Structures
>
[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct CRYPT
{
public uint size;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = 120)]
public string buffer;
public uint offset;
>
}
>
[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct SDCConfig
{
[MarshalAs(Unman agedType.ByValT Str, SizeConst = CONFIG_NAME_SZ)]
public string configName;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = SSID_SZ)]
public string SSID;
[MarshalAs(Unman agedType.ByValT Str, SizeConst = CLIENT_NAME_SZ)]
public string clientName;
public Int32 txPower;
public AUTH authType;
public EAPTYPE eapType;
public POWERSAVE powerSave;
public WEPTYPE wepType;
public BITRATE bitRate;
public RADIOMODE radioMode;
public CRYPT userName;
public CRYPT userPwd;
public CRYPT PSK;
public CRYPT WEPKeys;
>
}
>
[DllImport("VPSu mmit.dll", CharSet = CharSet.Unicode )]
public static extern SDCERR GetConfig([MarshalAs(Unman aged.Type.LPArr ay)]
byte [] name, ref SDCCONFIG cfg)];
>
and the function call is:
public bool ConfigTest
{
string configName = "VANPUTER";
byte [] Name = System.Text.ASC IIEncoding.ASCI I.GetBytes(Conf igName +
'\0');
SDCConfig cfg = new SDCConfig();
SDCERR result = GetConfig(Name, cfg);
return (result = SDCERR_SUCCESS) ;
>
}

One thing that immediately looks wrong here is that all your C structs
use char strings (that is, non-Unicode), but you use CharSet.Unicode
combined with UnmanagedType.B yValTStr - that would make them all
Unicode for marshalling, and skew the layout of following fields
(since now they suddenly are twice as far as they ought to be). Try
using CharSet.Ansi instead and see if that helps.

**Andy Baker** · Jul 16 '08, 08:45 AM

Re: Passing Structures to Unmanaged Code

>One thing that immediately looks wrong here is that all your C structs

>use char strings (that is, non-Unicode), but you use CharSet.Unicode
>combined with UnmanagedType.B yValTStr - that would make them all
>Unicode for marshalling, and skew the layout of following fields
>(since now they suddenly are twice as far as they ought to be). Try
>using CharSet.Ansi instead and see if that helps.

I tried that already - but I am using the compact framework, and don't
appear to have the option of Ansi - I though CE used Unicode anyway. The
only options I get are CharSet.Unicode and CharSet.Auto, and have tried both
with the same result. What is the alternative to ByValTStr - that was the
only option I tried that didn't give me the NotSupportedExc eption, but still
didn't do what I wanted it to.

**Andy Baker** · Jul 16 '08, 01:45 PM

Re: Passing Structures to Unmanaged Code

I seem to have got the strings working now - I declared everything as a byte
array instead of a string in the structure definition, and used
MarshalAs[UnmanagedType.B yValArray)], and now when I make my function call
and convert between string and byte array and back, I get the results I am
expecting.
However, I still have a problem with the rest of the structure(s),
defined in the C header file as follows:

typedef struct _CRYPT {
DWORD size;
char buffer[120];
DWORD offset;
} CRYPT;

typedef struct _SDCConfig {
char configName[CONFIG_NAME_SZ];
char SSID[SSID_SZ];
char clientName[CLIENT_NAME_SZ];
int txPower;
AUTH authType;
EAPTYPE eapType;
POWERSAVE powerSave;
WEPTYPE wepType;
BITRATE bitRate;
RADIOMODE radioMode;
CRYPT userName;
CRYPT userPwd;
CRYPT PSK;
CRYPT WEPKeys;
} SDCConfig

My C# structure definitions are now defined as follows:

[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct CRYPT
{
public Uint32 size;
[MarshalAs(Unman agedType.ByValA rray, SizeConst = 120)]
public byte[] buffer;
public Uint32 offset;
}

[StructLayout(La youtKind.Sequen tial, CharSet = CharSet.Unicode )]
public struct SDCConfig
{
[MarshalAs(Unman agedType.ByValA rray, SizeConst = CONFIG_NAME_SZ)]
public byte[] configName;
[MarshalAs(Unman agedType.ByValA rray, SizeConst = SSID_SZ)]
public byte[] SSID;
[MarshalAs(Unman agedType.ByValA rray, SizeConst = CLIENT_NAME_SZ)]
public byte[] clientName;
public Int32 txPower;
public AUTH authType;
public EAPTYPE eapType;
public POWERSAVE powerSave;
public WEPTYPE wepType;
public BITRATE bitRate;
public RADIOMODE radioMode;
public CRYPT userName;
public CRYPT userPwd;
public CRYPT PSK;
public CRYPT WEPKeys;
}

When I make the function call, the arrays configName, SSID and clientName
all now contain the correct values - unfortunately the rest of the fields
don't. I have replaced int in the C definition by Int32 in C# - as far as I
can see this is correct, but I am unsure how to deal with the others. In C,
they are all defined as enumerations i.e.:

typedef enum _AUTH {
AUTH_OPEN = 0,
AUTH_SHARED,
AUTH_NETWORK_EA P,
} AUTH;

which I have defined in C# as:

public enum AUTH { AUTH_OPEN = 0, AUTH_SHARED, AUTH_NETWORK_EA P };

Do I have to define the data type as well somewhere? I see that if no
underlying type is specifically declared, then Int32 is used, but is this
the same as in C++?. If the data type is wrong and the C# definition is
taking up more (or less) bytes than it should be then it would explain the
results that I am getting - instead of enumerations such as AUTH_OPEN,
AUTH_SHARED etc, the value AUTH contains a large (random) number, and so do
all the other enumerations. Thanks for any advice.

Andy Baker

**Pavel Minaev** · Jul 17 '08, 06:35 AM

Re: Passing Structures to Unmanaged Code

On Jul 16, 5:40 pm, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

When I make the function call, the arrays configName, SSID and clientName
all now contain the correct values - unfortunately the rest of the fields
don't. I have replaced int in the C definition by Int32 in C# - as far asI
can see this is correct, but I am unsure how to deal with the others. In C,
they are all defined as enumerations i.e.:
>
typedef enum _AUTH {
AUTH_OPEN = 0,
AUTH_SHARED,
AUTH_NETWORK_EA P,
>
} AUTH;
>
which I have defined in C# as:
>
public enum AUTH { AUTH_OPEN = 0, AUTH_SHARED, AUTH_NETWORK_EA P };
>
Do I have to define the data type as well somewhere? I see that if no
underlying type is specifically declared, then Int32 is used, but is this
the same as in C++?.

Unfortunately, this is essentially implementation-defined in C++.
Visual C++ defaults to int on the desktop, but this can be overridden
with compiler flags to use the smallest fitting type instead, and I've
no idea what the default is for the WinCE compiler. One way to know
for sure is to write a small C++ program that just prints sizeof on
all members of the struct.

**Andy Baker** · Jul 17 '08, 11:15 AM

Re: Passing Structures to Unmanaged Code

>Unfortunatel y, this is essentially implementation-defined in C++.

>Visual C++ defaults to int on the desktop, but this can be overridden
>with compiler flags to use the smallest fitting type instead, and I've
>no idea what the default is for the WinCE compiler. One way to know
>for sure is to write a small C++ program that just prints sizeof on
>all members of the struct.

I have done that, and the C++ enumerations are all 4-byte integers, so it
looks like they should be the same in C#.
One thing that I have found is that if I did sizeof on the whole structure
in C++, it returns 523, which is what I would expect:
configName 33
SSID 33
clientName 17
txPower 4
authType 4
eapType 4
powerSave 4
wepType 4
bitRate 4
radioMode 4
userName 128
userPwd 128
PSK 128
WEPkeys 128
The last 128 byte elements are all of type CRYPT which consists of a char
array of size 120 and 2 integers = 128. The first 3 are all char arrays in
C++ which I have converted to byte arrays from a string in C#, and added a
'\0' on the end - assuming the extra byte (33 instead of 32 and 17 instead
of 16 is for the '\0'). This bit seems to work anyway. The thing that struck
me as strange is that if I tried getting the size of the structure I am
passing from C# using MarshalAs.SizeO f(cfg) where cfg is the a variable of
the structure type, it gives me 524, although when I look at the individual
elements they are all the right size - I am passing byte arrays of the
correct size, the enumerations are all Int32 and the CRYPTs are all 128. I
also have a second structure in this application, and doing the same
exercise with that gives me a C# size of 128 against a C++ size of 127,
again an extra byte. I can't understand where this is coming from, or if it
makes a difference. If it is adding a byte at the end, maybe it doesn't
matter, but for some reason it appears to be going wrong after clientName as
all the rest of the elements contains nonsense values.

**Pavel Minaev** · Jul 17 '08, 12:35 PM

Re: Passing Structures to Unmanaged Code

On Jul 17, 3:14 pm, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

Unfortunately, this is essentially implementation-defined in C++.
Visual C++ defaults to int on the desktop, but this can be overridden
with compiler flags to use the smallest fitting type instead, and I've
no idea what the default is for the WinCE compiler. One way to know
for sure is to write a small C++ program that just prints sizeof on
all members of the struct.

>
I have done that, and the C++ enumerations are all 4-byte integers, so it
looks like they should be the same in C#.
One thing that I have found is that if I did sizeof on the whole structure
in C++, it returns 523, which is what I would expect:
configName 33
SSID 33
clientName 17
txPower 4
authType 4
eapType 4
powerSave 4
wepType 4
bitRate 4
radioMode 4
userName 128
userPwd 128
PSK 128
WEPkeys 128
The last 128 byte elements are all of type CRYPT which consists of a char
array of size 120 and 2 integers = 128. The first 3 are all char arraysin
C++ which I have converted to byte arrays from a string in C#, and added a
'\0' on the end - assuming the extra byte (33 instead of 32 and 17 instead
of 16 is for the '\0'). This bit seems to work anyway. The thing that struck
me as strange is that if I tried getting the size of the structure I am
passing from C# using MarshalAs.SizeO f(cfg) where cfg is the a variable of
the structure type, it gives me 524, although when I look at the individual
elements they are all the right size - I am passing byte arrays of the
correct size, the enumerations are all Int32 and the CRYPTs are all 128. I
also have a second structure in this application, and doing the same
exercise with that gives me a C# size of 128 against a C++ size of 127,
again an extra byte. I can't understand where this is coming from, or if it
makes a difference. If it is adding a byte at the end, maybe it doesn't
matter, but for some reason it appears to be going wrong after clientNameas
all the rest of the elements contains nonsense values.

Ah, that explains things now. It seems that the C++ code is compiled
with struct padding disabled. Normally, in C++, struct fields are
padded so that every field's alignment is the same as its size (i.e.
bytes are not aligned at all, Int16 are aligned on 2-byte boundaries,
Int32 are aligned on 4-byte boundaries, etc). C# uses the same logic
by default, IIRC, but it can be changed via StructLayoutAtt ribute.Pack
property - try setting it to 1.

In your case, the first 3 fields are not aligned since they are byte
arrays. Their total size is 33+33+17=83. However, since the next field
is Int32, it expects to be aligned at 4-byte boundary, and so a byte
of padding is added before it so that it will start at byte #84 (which
is divisible by 4).

**raylopez99** · Jul 17 '08, 12:55 PM

Re: Passing Structures to Unmanaged Code

On Jul 17, 4:14 am, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

[problems with structures in C#]

I'm just a newbie, but I once read about a guy having problems with
structures, and he solved the problem by simply declaring the
structures as a public class. That simple. Apparently classes, which
live on the heap, are different from structures that live on the
stack. Or so I believe. If it's easy you might want to make this
change and see what happens.

Ever since I read this, I don't use structures in CLI .NET managed
code.

RL

**Pavel Minaev** · Jul 17 '08, 01:25 PM

Re: Passing Structures to Unmanaged Code

On Jul 17, 4:50 pm, raylopez99 <raylope...@yah oo.comwrote:

I'm just a newbie, but I once read about a guy having problems with
structures, and he solved the problem by simply declaring the
structures as a public class. That simple.

I doubt that would make any difference, since field layout in both is
exactly the same (when LayoutKind.Sequ ential or Explicit is used, and
you can't marshal with Auto anyway), and that's all that matters.

> Apparently classes, which live on the heap, are different from structures that live on the
stack.

Not in any way that is relevant to the issue at hand.

Ever since I read this, I don't use structures in CLI .NET managed
code.

While there are valid philosophical and practical reasons for avoiding
structs in .NET, this one isn't either. It's better to fully
comprehend the issue before making such broad decisions, and, from
what you say, it is clear that you do not understand them at all.

**Andy Baker** · Jul 17 '08, 02:15 PM

Re: Passing Structures to Unmanaged Code

but it can be changed via StructLayoutAtt ribute.Pack property - try

setting it to 1.
>In your case, the first 3 fields are not aligned since they are byte
>arrays. Their total size is 33+33+17=83. However, since the next field
>is Int32, it expects to be aligned at 4-byte boundary, and so a byte
>of padding is added before it so that it will start at byte #84 (which
>is divisible by 4).

That makes alot of sense. If I make the same function call in C++ it returns
sensible values so it is definitely working with a structure size of 623. In
the .h header file there is a line that says #pragma pack(1) - does this do
what you are saying and disable struct padding? However, the compact
framework 2.0 does not appear to support the Pack property - there is not an
option. I tried setting it to LayoutKind.Expl icit and using FieldOffset in
the structure definition, but this just gives me a TypeLoadExcepti on. Is
there another way to do this? I am nearly there - thanks for all your help
so far.

Andy Baker

**Pavel Minaev** · Jul 17 '08, 02:35 PM

Re: Passing Structures to Unmanaged Code

On Jul 17, 6:13 pm, "Andy Baker" <aba...@NOSPAMv anputer.comwrot e:

That makes alot of sense. If I make the same function call in C++ it returns
sensible values so it is definitely working with a structure size of 623.In
the .h header file there is a line that says #pragma pack(1) - does this do
what you are saying and disable struct padding?

Yes, it is precisely that.

However, the compact
framework 2.0 does not appear to support the Pack property - there is notan
option. I tried setting it to LayoutKind.Expl icit and using FieldOffset in
the structure definition, but this just gives me a TypeLoadExcepti on. Is
there another way to do this? I am nearly there - thanks for all your help
so far.

It would seem that there is no general workaround in that case - .NET
CE does not indeed support Pack, and Explicit alone is not enough
(it'll still pad the fields by default). The only way to work around
this limitation in general is to marshal the entire struct as byte[],
and use BitConverter.Ge tBytes + Buffer.BlockCop y to put data into it,
and BitConverter.To XXX to extract it.

For your case, however, it might just be easier to cheat and add a
dummy byte field between clientName and txPower to account for the
padding. You do not need to care about its value, either - whatever
goes there is fine.

**Andy Baker** · Jul 17 '08, 04:15 PM

Re: Passing Structures to Unmanaged Code

I only have 2 structures and I've done the first one successfully like that.
The second is a little more complicated but shouldn't be a problem. Thanks
again for your help.

Passing Structures to Unmanaged Code

Passing Structures to Unmanaged Code

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment