.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 博客园 -- 精简开发 无线生活