由于CF是一个精简(Compact)的.NET Framework,因此在开发CF应用时有一部分功能MS并没有在CF中实现,需要直接调用Win32的API来实现。由于Win32的API是面向native代码的,一般会提供一个DLL库以及相应header文件。使用C++是十分容易和简单调用这些API,但是使用C# .NET就没那么幸运了。C#调用Win32的API往往要借助于P/Invoke的帮助,下面讲述一下P/Invoke 的使用。
API的引入
调用Win32的API需要引入相应的DLL,Wince下大部分的API存在于coredll.dll里面,同时DllImport不仅仅支持Win32 API,他可以支持任何native 的DLL的引入。
错误情况处理
调用Win32的API一般通过返回值表示调用结果,推荐使用Exception代替返回值的方式表达错误和异常情况。
if (lStatus != 0 )
{
throw new ApplicationException( " RasHangUp( " + rasSession + " ) failed with error code: " + lStatus);
}
参数的转换
调用Win32的API大部分工作就是在对调用参数进行类型转换,这些参数基于.NET的角度叫做unmanaged type(native type),对应于.NET built-in 的managed type.例如调用查询所有WiFi网卡信息的接口,入口参数为LPWSTR和PINTFS_KEY_TABLE,LPWSTR是字符串指针( Long Pointer to Wide String),而PINTFS_KEY_TABLE是一个结构体。
LPWSTR pSrvAddr,
PINTFS_KEY_TABLE pIntfs
);
typedef struct
{
DWORD dwNumIntfs;
PINTF_KEY_ENTRY pIntfs;
} INTFS_KEY_TABLE, *PINTFS_KEY_TABLE;
在CF.NET中会转化成下面接口,其中INTFS_KEY_TABLE为一个自定义的结构体。
public static extern uint WZCEnumInterfaces( string pSrvAddr, ref INTFS_KEY_TABLE pIntfs);
public struct INTFS_KEY_TABLE : IDisposable
{
private uint dwNumIntfs;
public IntPtr pIntfs;
public INTFS_KEY_TABLE(uint size)
{
this.dwNumIntfs = size;
if (size != 0)
{
this.pIntfs = Marshal.AllocHGlobal((int)(Marshal.SizeOf(typeof(IntPtr)) * size));
}
else
{
this.pIntfs = IntPtr.Zero;
}
}
public string this[uint i]
{
get
{
return Marshal.PtrToStringUni((IntPtr)Marshal.ReadInt32(this.pIntfs, (int)(i * 4)));
}
}
public uint Count
{
get
{
return this.dwNumIntfs;
}
}
public void Dispose()
{
if (this.pIntfs != IntPtr.Zero)
{
Marshal.FreeHGlobal(this.pIntfs);
}
}
}
所有类型转换都是基于基本类型,所以要进行类型转换要从基本类型入手。
c++ int类型(int, short, long, uint)直接转
c++ float类型(double, float)直接转
byte转成uint
bool要转成int
enum转成uint
{
INTF_ALL = 0xffffffff ,
INTF_ALL_FLAGS = 0x0000ffff ,
/// <summary>
/// mask for the configuration mode (NDIS_802_11_NETWORK_INFRASTRUCTURE value)
/// </summary>
INTF_CM_MASK = 0x00000007 ,
}
char不能转,因为c++里面的char是1byte,而.NET是2bytes
对于结构体的转换可以自定义一个结构,例如上列子的INTFS_KEY_TABLE。如果结构体里面还包含结构体可以使用byte[]或者IntPtr来表示,因为c++里面的struct就是内存加上offset。
这些我做P/Invoke找到的一些规律,但是发现不同API,转换还是有点不一样,上面只是列出一般情况,特殊情况还要根据列子进行调整。
参考文献
Marshalling: Using native DLLs in .NET
.NET Compact Framework, WinCE, Windows Mobile开发系列
Jake's Blog in 博客园 -- 精简开发 无线生活