.NET Compact Framework 下Win32 API P/Invoke 的使用

由于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的引入。

 

[DllImport("coredll.dll", CharSet = CharSet.Auto)]

 

错误情况处理

调用Win32的API一般通过返回值表示调用结果,推荐使用Exception代替返回值的方式表达错误和异常情况。

int lStatus = RasHangUp(rasSession);
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是一个结构体。

DWORD WZCEnumInterfaces(
  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为一个自定义的结构体。

[DllImport("wzcsapi.dll")]
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

 

public enum INTF_FLAGS : 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

DllImportAttribute Class

 

.NET Compact Framework, WinCE, Windows Mobile开发系列
Jake's Blog in 博客园 -- 精简开发 无线生活


posted @ 2009-01-09 08:58  Jake Lin  阅读(4853)  评论(7编辑  收藏  举报