在Visual C#中运用API函数获取系统信息

API函数是构筑Windows应用程序基石，是Windows编程必备利器。每一种Windows应用程序开发工具都提供了间接或直接调用了Windows API函数方法，或者是调用Windows API函数接口，也就是说具备调用动态连接库能力。Visual C#和其它开发工具一样也能够调用动态链接库API函数。本文中笔者就结合实例向大家介绍在Visual C#中如何调用各种返回值API，该实例就是一个通过API函数调用获取系统信息程序。

　　在Visual C#中调用API基本过程：

　　首先，在调用API之前，你必须先导入System.Runtime.InteropServices这个名称空间。该名称空间包含了在Visual C#中调用API一些必要集合，具体方法如下：

　　using System.Runtime.InteropServices;

　　在导入了名称空间后，我们要声明在程序中所要用到API函数。我们程序主要是获取系统相关信息，所以用到API函数都是返回系统信息。先给出在Visual C#中声明API方法：

　　[DllImport("kernel32")]
    public static extern void GetWindowsDirectory(StringBuilder WinDir,int count);

　　其中，"DllImport"属性用来从不可控代码中调用一个方法，它指定了DLL位置，该DLL中包含调用外部方法；"kernel32"设定了类库名；"public"指明函数访问类型为公有；"static"修饰符声明一个静态元素，而该元素属于类型本身而不是指定对象；"extern"表示该方法将在工程外部执行，同时使用DllImport导入方法必须使用"extern"修饰符；最后GetWindowsDirectory函数包含了两个参数，一个为StringBuilder类型，另一个为int类型，该方法返回内容存在于StringBuilder类型参数中。同时，因为我们在这里使用到了StringBuilder类，所以在程序开始处，我们还得添加System.Text这个名称空间，方法同上。

　　其他几个API函数声明如下：

[DllImport("kernel32")]
    public static extern void GetSystemDirectory(StringBuilder SysDir,int count);
[DllImport("kernel32")]
    public static extern void GetSystemInfo(ref CPU_INFO cpuinfo);
[DllImport("kernel32")]
    public static extern void GlobalMemoryStatus(ref MEMORY_INFO meminfo);
[DllImport("kernel32")]
    public static extern void GetSystemTime(ref SYSTEMTIME_INFO stinfo);

　　以上几个API作用分别是获取系统路径，获得CPU相关信息，获得内存相关信息，获得系统时间等。
　　在声明完所有API函数后，我们发现后三个函数分别用到了CPU_INFO、MEMORY_INFO、SYSTEMTIME_INFO等结构，这些结构并非是.Net内部，它们从何而来？其实，我们在用到以上API调用时均需用到以上结构，我们将函数调用获得信息存放在以上结构体中，最后返回给程序输出。这些结构体比较复杂，但是如果开发者能够熟练运用，那么整个API世界将尽在开发者掌握之中。以下就是上述结构体声明：

　　//定义以下各结构

//定义CPU信息结构
[StructLayout(LayoutKind.Sequential)]
public struct CPU_INFO
{
    public uint dwOemId;
    public uint dwPageSize;
    public uint lpMinimumApplicationAddress;
    public uint lpMaximumApplicationAddress;
    public uint dwActiveProcessorMask;
    public uint dwNumberOfProcessors;
    public uint dwProcessorType;
    public uint dwAllocationGranularity;
    public uint dwProcessorLevel;
    public uint dwProcessorRevision;
}

//定义内存信息结构
[StructLayout(LayoutKind.Sequential)]
public struct MEMORY_INFO
{
    public uint dwLength;
    public uint dwMemoryLoad;
    public uint dwTotalPhys;
    public uint dwAvailPhys;
    public uint dwTotalPageFile;
    public uint dwAvailPageFile;
    public uint dwTotalVirtual;
    public uint dwAvailVirtual;
}

//定义系统时间信息结构
[StructLayout(LayoutKind.Sequential)] 字串1
public struct SYSTEMTIME_INFO
{
    public ushort wYear;
    public ushort wMonth;
    public ushort wDayOfWeek;
    public ushort wDay;
    public ushort wHour;
    public ushort wMinute;
    public ushort wSecond;
    public ushort wMilliseconds;
}

　　结构体定义主体部分和C 中没多大差别，具体每个结构体内部成员定义可参考联机帮助中SDK文档。同时，我们还发现在每个结构体定义上面都有一句用中括号括起来说明性文字。这些说明都是有关结构体成员布局，共有三种选项，分别说明如下：

　　LayoutKind.Automatic：为了提高效率允许运行态对类型成员重新排序。

　　注意：永远不要使用这个选项来调用不受管辖动态链接库函数。

　　LayoutKind.Explicit：对每个域按照FieldOffset属性对类型成员排序

　　LayoutKind.Sequential：对出现在受管辖类型定义地方不受管辖内存中类型成员进行排序。

　　在上面程序中，为了方便起见我们都用到了第三种方式。　

　　所有API函数以及相关结构体声明完毕后，我们就运用这些API来实现我们程序功能――获取系统相关信息。

　　简单界面布置后，我们添加一个按钮（"获取信息"按钮）消息处理函数如下：

　　private void GetInfo_Click(object sender, System.EventArgs e)
{
//调用GetWindowsDirectory()函数和GetSystemDirectory()函数分别取得Windows路径和系统路径
    const int nChars = 128;
    StringBuilder Buff = new StringBuilder(nChars);
    GetWindowsDirectory(Buff,nChars); //取得Windows路径
    WindowsDirectory.Text = "Windows路径：" Buff.ToString();
    GetSystemDirectory(Buff,nChars); //取得系统路径
    SystemDirectory.Text = "系统路径：" Buff.ToString();

//调用GetSystemInfo函数获取CPU相关信息
    CPU_INFO CpuInfo;
    CpuInfo = new CPU_INFO();
    GetSystemInfo(ref CpuInfo);
    NumberOfProcessors.Text = "本计算机中有" CpuInfo.dwNumberOfProcessors.ToString() "个CPU";
    ProcessorType.Text = "CPU类型为" CpuInfo.dwProcessorType.ToString();
    ProcessorLevel.Text = "CPU等级为" CpuInfo.dwProcessorLevel.ToString();
    OemId.Text = "CPUOEM ID为" CpuInfo.dwOemId.ToString();
    PageSize.Text = "CPU中页面大小为" CpuInfo.dwPageSize.ToString();

//调用GlobalMemoryStatus函数获取内存相关信息
    MEMORY_INFO MemInfo;
    MemInfo = new MEMORY_INFO();
    GlobalMemoryStatus(ref MemInfo);
    MemoryLoad.Text = MemInfo.dwMemoryLoad.ToString() "%内存正在使用";
    TotalPhys.Text = "物理内存：" MemInfo.dwTotalPhys.ToString() "字节";
    AvailPhys.Text = "可用物理内存：" MemInfo.dwAvailPhys.ToString() "字节";
    TotalPageFile.Text = "交换文件总大小为" MemInfo.dwTotalPageFile.ToString() "字节";
    AvailPageFile.Text = "尚可交换文件大小为" MemInfo.dwAvailPageFile.ToString() "字节";
    TotalVirtual.Text = "总虚拟内存有" MemInfo.dwTotalVirtual.ToString() "字节";
    AvailVirtual.Text = "未用虚拟内存有" MemInfo.dwAvailVirtual.ToString() "字节";

//调用GetSystemTime函数获取系统时间信息
    SYSTEMTIME_INFO StInfo;
    StInfo = new SYSTEMTIME_INFO();
    GetSystemTime(ref StInfo);
    Date.Text = StInfo.wYear.ToString() "年" StInfo.wMonth.ToString() "月" StInfo.wDay.ToString() "日";
    Time.Text = (StInfo.wHour 8).ToString() "点" StInfo.wMinute.ToString() "分" StInfo.wSecond.ToString() "秒";
}

　　在上面消息处理函数中，我们运用了在程序开始处声明各个API函数获取了系统相关信息，并最终在界面上以文本标签方式显示结果。各个文本标签命名方式可以参见文后附带源代码，此处暂略。