C#調(diào)用Windows API函數(shù)
Api函數(shù)是構(gòu)筑Windws應(yīng)用程序的基石，每一種Windows應(yīng)用程序開發(fā)工具，它提供的底層函數(shù)都間接或直接地C#調(diào)用Windows API函數(shù)，同時(shí)為了實(shí)現(xiàn)功能擴(kuò)展，一般也都提供了C#調(diào)用Windows API函數(shù)的接口， 也就是說(shuō)具備調(diào)用動(dòng)態(tài)連接庫(kù)的能力。Visual C#和其它開發(fā)工具一樣也能夠調(diào)用動(dòng)態(tài)鏈接庫(kù)的API函數(shù)。.NET框架本身提供了這樣一種服務(wù),允許受管轄的代碼調(diào)用動(dòng)態(tài)鏈接庫(kù)中實(shí)現(xiàn)的非受管轄函數(shù),包括操作系統(tǒng)提供的Windows API函數(shù)。它能夠定位和調(diào)用輸出函數(shù),根據(jù)需要，組織其各個(gè)參數(shù)(整型、字符串類型、數(shù)組、和結(jié)構(gòu)等等)跨越互操作邊界。
下面以C#為例簡(jiǎn)單介紹調(diào)用API的基本過(guò)程：
動(dòng)態(tài)鏈接庫(kù)函數(shù)的聲明
動(dòng)態(tài)鏈接庫(kù)函數(shù)使用前必須聲明，相對(duì)于VB,C#函數(shù)聲明顯得更加羅嗦，前者通過(guò) Api Viewer粘貼以后，可以直接使用，而后者則需要對(duì)參數(shù)作些額外的變化工作。
動(dòng)態(tài)鏈接庫(kù)函數(shù)聲明部分一般由下列兩部分組成，一是函數(shù)名或索引號(hào)，二是動(dòng)態(tài)鏈接庫(kù)的文件名。
譬如，你想調(diào)用User32.DLL中的MessageBox函數(shù)，我們必須指明函數(shù)的名字MessageBoxA或MessageBoxW，以及庫(kù)名字 User32.dll,我們知道Win32 API對(duì)每一個(gè)涉及字符串和字符的函數(shù)一般都存在兩個(gè)版本，單字節(jié)字符的ANSI版本和雙字節(jié)字符的UNICODE版本。
下面是一個(gè)調(diào)用API函數(shù)的例子：
- [DllImport("KERNEL32.DLL", EntryPoint="MoveFileW", SetLastError=true,
- CharSetCharSet=CharSet.Unicode, ExactSpelling=true,
- CallingConventionCallingConvention=CallingConvention.StdCall)]
- public static extern bool MoveFile(String src, String dst);
其中入口點(diǎn)EntryPoint標(biāo)識(shí)函數(shù)在動(dòng)態(tài)鏈接庫(kù)的入口位置，在一個(gè)受管轄的工程中，目標(biāo)函數(shù)的原始名字和序號(hào)入口點(diǎn)不僅標(biāo)識(shí)一個(gè)跨越互操作界限的函數(shù)。而且，你還可以把這個(gè)入口點(diǎn)映射為一個(gè)不同的名字，也就是對(duì)函數(shù)進(jìn)行重命名。重命名可以給調(diào)用函數(shù)帶來(lái)種種便利，通過(guò)重命名，一方面我們不用為函數(shù)的大小寫傷透腦筋，同時(shí)它也可以保證與已有的命名規(guī)則保持一致，允許帶有不同參數(shù)類型的函數(shù)共存，更重要的是它簡(jiǎn)化了對(duì)ANSI和Unicode版本的調(diào)用。CharSet用于標(biāo)識(shí)函數(shù)調(diào)用所采用的是Unicode或是ANSI版本，ExactSpelling＝false將告訴編譯器,讓編譯器決定使用 Unicode或者是Ansi版本。其它的參數(shù)請(qǐng)參考MSDN在線幫助.
在C#中，你可以在EntryPoint域通過(guò)名字和序號(hào)聲明一個(gè)動(dòng)態(tài)鏈接庫(kù)函數(shù)，如果在方法定義中使用的函數(shù)名與DLL入口點(diǎn)相同，你不需要在EntryPoint域顯示聲明函數(shù)。否則，你必須使用下列屬性格式指示一個(gè)名字和序號(hào)。
[DllImport("dllname", EntryPoint="Functionname")]
[DllImport("dllname", EntryPoint="#123")]
值得注意的是，你必須在數(shù)字序號(hào)前加“＃”
下面是一個(gè)用MsgBox替換MessageBox名字的例子：
- using System.Runtime.InteropServices;
- public class Win32 {
- [DllImport("user32.dll", EntryPoint="MessageBox")]
- public static extern int MsgBox(int hWnd, String text, String caption, uint type);
- }
許多受管轄的動(dòng)態(tài)鏈接庫(kù)函數(shù)期望你能夠傳遞一個(gè)復(fù)雜的參數(shù)類型給函數(shù)，譬如一個(gè)用戶定義的結(jié)構(gòu)類型成員或者受管轄代碼定義的一個(gè)類成員，這時(shí)你必須提供額外的信息格式化這個(gè)類型，以保持參數(shù)原有的布局和對(duì)齊。
C#提供了一個(gè)StructLayoutAttribute類，通過(guò)它你可以定義自己的格式化類型，在受管轄代碼中，格式化類型是一個(gè)用StructLayoutAttribute說(shuō)明的結(jié)構(gòu)或類成員，通過(guò)它能夠保證其內(nèi)部成員預(yù)期的布局信息。布局的選項(xiàng)共有三種：
布局選項(xiàng)
描述
◆LayoutKind.Automatic
為了提高效率允許運(yùn)行態(tài)對(duì)類型成員重新排序。
注意：永遠(yuǎn)不要使用這個(gè)選項(xiàng)來(lái)調(diào)用不受管轄的動(dòng)態(tài)鏈接庫(kù)函數(shù)。
◆LayoutKind.Explicit
對(duì)每個(gè)域按照FieldOffset屬性對(duì)類型成員排序
◆LayoutKind.Sequential
對(duì)出現(xiàn)在受管轄類型定義地方的不受管轄內(nèi)存中的類型成員進(jìn)行排序。
傳遞結(jié)構(gòu)成員
下面的例子說(shuō)明如何在受管轄代碼中定義一個(gè)點(diǎn)和矩形類型，并作為一個(gè)參數(shù)傳遞給User32.dll庫(kù)中的PtInRect函數(shù)，
函數(shù)的不受管轄原型聲明如下：
BOOL PtInRect(const RECT *lprc, POINT pt);
注意你必須通過(guò)引用傳遞Rect結(jié)構(gòu)參數(shù)，因?yàn)楹瘮?shù)需要一個(gè)Rect的結(jié)構(gòu)指針。
- using System.Runtime.InteropServices;
- [StructLayout(LayoutKind.Sequential)]
- public struct Point {
- public int x;
- public int y;
- }
- [StructLayout(LayoutKind.Explicit]
- public struct Rect {
- [FieldOffset(0)] public int left;
- [FieldOffset(4)] public int top;
- [FieldOffset(8)] public int right;
- [FieldOffset(12)] public int bottom;
- }
- class Win32API {
- [DllImport("User32.dll")]
- public static extern Bool PtInRect(ref Rect r, Point p);
- }
- 類似你可以調(diào)用GetSystemInfo函數(shù)獲得系統(tǒng)信息：
- ? using System.Runtime.InteropServices;
- [StructLayout(LayoutKind.Sequential)]
- public struct SYSTEM_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;
- }
- [DllImport("kernel32")]
- static extern void GetSystemInfo(ref SYSTEM_INFO pSI);
- SYSTEM_INFO pSI = new SYSTEM_INFO();
- GetSystemInfo(ref pSI);
在C#調(diào)用Windows API函數(shù)時(shí)，大部分函數(shù)采用指針傳遞參數(shù)，對(duì)一個(gè)結(jié)構(gòu)變量指針，我們除了使用上面的類和結(jié)構(gòu)方法傳遞參數(shù)之外，我們有時(shí)還可以采用數(shù)組傳遞參數(shù)。
【編輯推薦】
