在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)]
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);
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 = "CPU的OEM 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()+"秒";
}