介绍
API( ApplicationProgrammingInterface ),我想大家不会陌生,它是我们Windows编程的常客,虽然基于.Net平台的C#有了强大的类库,但是,我们还是不能否认API在Windows编程中的重要性.大多数的编程语言都支持API编程,而.Net平台中的MFC(MicrosoftFoundationClassLibrary)构架本身就封装了大部分的API.
做为程序员,我们需要了解API从字面上了解便是编程接口,因此,做为开发者,需要了解的只是API的使用方法.
API根据操作系统、处理器及功能性的不同而拥有很多不同的类型. 操作系统特用的API:
每种操作系统都有许多通用的API以及一些特用的API,这些特用的API只能在当前操作系统中执行.
例如：
WindowsNT 支持 MS-DOS, Win16, Win32, POSIX ( PortableOperatingSystemInterface ), OS/2consoleAPI; 而 Windows95 支持 MS-DOS, Win16 以及 Win32APIs.
Win16 & Win32API:
Win16是为十六位处理器开发的,早期的操作系统均支持.
Win32则是为32位处理器开发.它可移植性强,被大部分的处理器所支持.
Win32API在库名后有一个”32”后缀.比如KERNEL32,USER32等.
所有API在下面3个库中得以运行：
KernelUserGDI1. KERNEL 他的库名为 KERNEL32.DLL, 他主要用于产生与操作系统之间的关联：
程序加载
上下文选择.
文件输入输出.
内存管理.
例如： GlobalMemoryStatus 函数就包括当前物理内存及虚拟内存的使用信息.
2. USER 这个类库在Win32中名叫 USER32.DLL.
它允许管理全部的用户接口,比如：
窗口
菜单
对话框
图标等.,
例如： DrawIcon 函数将在指定的设备关联上“画”出图标或者鼠标.
3. GDI ( GraphicalDeviceInterface )
它在Win32中的库名为：GDI32.dll,它是图形输出库.使用GDIWindows“画”出窗口、菜单以及对话框等：
它能创建图形输出.
它也能保存图形文件.
例如： CreateBitmap 函数就能通过指定的长、宽、颜色创建一个位图.
C# 中操作API :
作为初学者来说,在C#中使用API确是一件令人头疼的问题.在使用API之间你必须知道如何在C#中使用结构、类型转换、安全/不安全代码,可控/不可控代码等许多知识.
一切从简单开始,复杂的大家一时不能接受.我们就从实现一个简单的MessageBox开始.首先打开VS.Net ,创建一个新的C#工程,并添加一个Button按钮.当这个按钮被点击,则显示一个MessageBox对话框.
即然我们需要引用外来库,所以必须导入一个Namespace：
usingSystem.Runtime.InteropServices;
接着添加下面的代码来声明一个API：
[DllImport( "User32.dll" )]
publicstaticexternintMessageBox( inth, stringm, stringc, inttype );
此处DllImport属性被用来从不可控代码中调用一方法.”User32.dll”则设定了类库名.DllImport属性指定dll的位置,这个dll中包括调用的外部方法.Static修饰符则声明一个静态元素,而这个元素属于类型本身而不是上面指定的对象.extern则表示这个方法将在工程外部执行,使用DllImport导入的方法必须使用extern修饰符.
MessageBox 则是函数名,拥有4个参数,其返回值为数字.
大多数的API都能传递并返回值.
添中Click点击事件代码:
protectedvoidbutton1_Click( objectsender, System.EventArgse )
{
MessageBox ( 0,"API Message Box","API Demo",0 );
}
编译并运行这个程序,当你点击按钮后,你将会看到对话框,这便是你使用的API函数.
使用结构体
操作带有结构体的API比使用简单的API要复杂的多.但是一旦你掌握了API的过程,那个整个API世界将在你的掌握之中.
下面的例子中我们将使用GetSystemInfoAPI 来获取整个系统的信息.
第一步还是打开C#建立一个Form工程,同样的添中一个Button按钮,在代码窗中输入下面的代码,导入Namespace：
usingSystem.Runtime.InteropServices;
声明一个结构体,它将做为GetSystemInfo的一个参数：
[StructLayout( LayoutKind.Sequential )]
publicstructSYSTEM_INFO {
publicuintdwOemId;
publicuintdwPageSize;
publicuintlpMinimumApplicationAddress;
publicuintlpMaximumApplicationAddress;
publicuintdwActiveProcessorMask;
publicuintdwNumberOfProcessors;
publicuintdwProcessorType;
publicuintdwAllocationGranularity;
publicuintdwProcessorLevel;
publicuintdwProcessorRevision;
}
声明API函数:
[DllImport( "kernel32" )]
staticexternvoidGetSystemInfo( refSYSTEM_INFOpSI );
添加下面的代码至按钮的点击事件处理中：
首先创建一个SYSTEM_INFO结构体,并将其传递给GetSystemInfo函数.
protectedvoidbutton1_Click ( objectsender, System.EventArgse )
{
try {
SYSTEM_INFOpSI = newSYSTEM_INFO( );
GetSystemInfo( refpSI );
//
//
//
一旦你接收到返回的结构体,那么就可以以返回的参数来执行操作了.
e.g.listBox1.InsertItem ( 0,pSI.dwActiveProcessorMask.ToString( ) );:
//
//
//
}
catch( Exceptioner )
{
MessageBox.Show ( er.Message );
}
}
调用API全部代码
//Created By Ajit Mungale
//程序补充 飞刀
namespaceUsingAPI{
usingSystem;
usingSystem.Drawing;
usingSystem.Collections;
usingSystem.ComponentModel;
usingSystem.WinForms;
usingSystem.Data;
usingSystem.Runtime.InteropServices;
//Struct 收集系统信息
[StructLayout( LayoutKind.Sequential )]
publicstructSYSTEM_INFO {
publicuintdwOemId;
publicuintdwPageSize;
publicuintlpMinimumApplicationAddress;
publicuintlpMaximumApplicationAddress;
publicuintdwActiveProcessorMask;
publicuintdwNumberOfProcessors;
publicuintdwProcessorType;
publicuintdwAllocationGranularity;
publicuintdwProcessorLevel;
publicuintdwProcessorRevision;
}
//struct 收集内存情况
[StructLayout( LayoutKind.Sequential )]
publicstructMEMORYSTATUS {
publicuintdwLength;
publicuintdwMemoryLoad;
publicuintdwTotalPhys;
publicuintdwAvailPhys;
publicuintdwTotalPageFile;
publicuintdwAvailPageFile;
publicuintdwTotalVirtual;
publicuintdwAvailVirtual;
}
publicclassForm1 : System.WinForms.Form {
privateSystem.ComponentModel.Containercomponents;
privateSystem.WinForms.MenuItemmenuAbout;
privateSystem.WinForms.MainMenumainMenu1;
privateSystem.WinForms.ListBoxlistBox1;
privateSystem.WinForms.Buttonbutton1;
//获取系统信息
[DllImport( "kernel32" )]
staticexternvoidGetSystemInfo( refSYSTEM_INFOpSI );
//获取内存信息
[DllImport( "kernel32" )]
staticexternvoidGlobalMemoryStatus( refMEMORYSTATUSbuf );
//处理器类型
publicconstintPROCESSOR_INTEL_386 = 386;
publicconstintPROCESSOR_INTEL_486 = 486;
publicconstintPROCESSOR_INTEL_PENTIUM = 586;
publicconstintPROCESSOR_MIPS_R4000 = 4000;
publicconstintPROCESSOR_ALPHA_21064 = 21064;
publicForm1( )
{
InitializeComponent( );
}
publicoverridevoidDispose( )
{
base.Dispose( );
components.Dispose( );
}
privatevoidInitializeComponent( )
{
this.components = newSystem.ComponentModel.Container ( );
this.mainMenu1 = newSystem.WinForms.MainMenu ( );
this.button1 = newSystem.WinForms.Button ( );
this.listBox1 = newSystem.WinForms.ListBox ( );
this.menuAbout = newSystem.WinForms.MenuItem ( );
mainMenu1.MenuItems.All = newSystem.WinForms.MenuItem[1] {this.menuAbout};
button1.Location = newSystem.Drawing.Point ( 148, 168 );
button1.Size = newSystem.Drawing.Size ( 112, 32 );
button1.TabIndex = 0;
button1.Text = "&Get Info";
button1.Click += newSystem.EventHandler ( this.button1_Click );
listBox1.Location = newSystem.Drawing.Point ( 20, 8 );
listBox1.Size = newSystem.Drawing.Size ( 368, 147 );
listBox1.TabIndex = 1;
menuAbout.Text = "&About";
menuAbout.Index = 0;
menuAbout.Click += newSystem.EventHandler ( this.menuAbout_Click );
this.Text = "System Information - Using API";
this.MaximizeBox = false;
this.AutoScaleBaseSize = newSystem.Drawing.Size ( 5, 13 );
this.MinimizeBox = false;
this.Menu = this.mainMenu1;
this.ClientSize = newSystem.Drawing.Size ( 408, 213 );
this.Controls.Add ( this.listBox1 );
this.Controls.Add ( this.button1 );
}
protectedvoidmenuAbout_Click ( objectsender, System.EventArgse )
{
Formabt=newabout( ) ;
abt.ShowDialog( );
}
protectedvoidbutton1_Click ( objectsender, System.EventArgse )
{
try {
SYSTEM_INFOpSI = newSYSTEM_INFO( );
GetSystemInfo( refpSI );
stringCPUType;
switch ( pSI.dwProcessorType )
{
casePROCESSOR_INTEL_386 :
CPUType= "Intel 386";
break;
casePROCESSOR_INTEL_486 :
CPUType = "Intel 486" ;
break;
casePROCESSOR_INTEL_PENTIUM :
CPUType = "Intel Pentium";
break;
casePROCESSOR_MIPS_R4000 :
CPUType = "MIPS R4000";
break;
casePROCESSOR_ALPHA_21064 :
CPUType = "DEC Alpha 21064";
break;
default :
CPUType = "( unknown )";
}
listBox1.InsertItem ( 0,"Active Processor Mask :"+pSI.dwActiveProcessorMask.ToString( ) );
listBox1.InsertItem ( 1,"Allocation Granularity :"+pSI.dwAllocationGranularity.ToString( ) );
listBox1.InsertItem ( 2,"Number Of Processors :"+pSI.dwNumberOfProcessors.ToString( ) );
listBox1.InsertItem ( 3,"OEM ID :"+pSI.dwOemId.ToString( ) );
listBox1.InsertItem ( 4,"Page Size:"+pSI.dwPageSize.ToString( ) );
listBox1.InsertItem ( 5,"Processor Level Value:"+pSI.dwProcessorLevel.ToString( ) );
listBox1.InsertItem ( 6,"Processor Revision:"+ pSI.dwProcessorRevision.ToString( ) );
listBox1.InsertItem ( 7,"CPU type:"+CPUType );
listBox1.InsertItem ( 8,"Maximum Application Address: "+pSI.lpMaximumApplicationAddress.ToString( ) );
listBox1.InsertItem ( 9,"Minimum Application Address:" +pSI.lpMinimumApplicationAddress.ToString( ) );
/************** 从 GlobalMemoryStatus 获取返回值****************/
MEMORYSTATUSmemSt = newMEMORYSTATUS ( );
GlobalMemoryStatus ( refmemSt );
listBox1.InsertItem( 10,"Available Page File :"+ ( memSt.dwAvailPageFile/1024 ).ToString ( ) );
listBox1.InsertItem( 11,"Available Physical Memory : " + ( memSt.dwAvailPhys/1024 ).ToString( ) );
listBox1.InsertItem( 12,"Available Virtual Memory:" + ( memSt.dwAvailVirtual/1024 ).ToString ( ) );
listBox1.InsertItem( 13,"Size of structur :" + memSt.dwLength.ToString( ) );
listBox1.InsertItem( 14,"Memory In Use :"+ memSt.dwMemoryLoad.ToString( ) );
listBox1.InsertItem( 15,"Total Page Size :"+ ( memSt.dwTotalPageFile/1024 ).ToString ( ) );
listBox1.InsertItem( 16,"Total Physical Memory :" + ( memSt.dwTotalPhys/1024 ).ToString( ) );
listBox1.InsertItem( 17,"Total Virtual Memory :" + ( memSt.dwTotalVirtual/1024 ).ToString ( ) );
}
catch( Exceptioner )
{
MessageBox.Show ( er.Message );
}
}
publicstaticvoidMain( string[] args )
{
try {
Application.Run( newForm1( ) );
}
catch( Exceptioner )
{
MessageBox.Show ( er.Message);
}
}
}
}