[DllImport] 呼叫 C/C++ DLL、Windows API、COM 元件。using System;
using System.Runtime.InteropServices;
public class WinMM {
// 1. 宣告外部方法:static extern + DllImport
[DllImport("winmm.dll", EntryPoint = "PlaySound",
SetLastError = true, CharSet = CharSet.Auto)]
public static extern bool PlaySound(string pszSound, IntPtr hmod, PlaySoundFlags fdwSound);
// 2. 定義旗標列舉 (對應 C++ DWORD)
[Flags]
public enum PlaySoundFlags : uint {
SND_SYNC = 0x0000, // 同步播放
SND_ASYNC = 0x0001, // 非同步
SND_NODEFAULT = 0x0002,
SND_LOOP = 0x0008,
SND_FILENAME = 0x00020000 // pszSound 為檔案路徑
}
// 3. 使用範例
public static void PlayWav(string path) {
if (!PlaySound(path, IntPtr.Zero, PlaySoundFlags.SND_SYNC | PlaySoundFlags.SND_FILENAME)) {
int err = Marshal.GetLastWin32Error();
throw new System.ComponentModel.Win32Exception(err, "PlaySound 失敗");
}
}
}
// 呼叫
WinMM.PlayWav(@"C:\Windows\Media\chord.wav");
| 屬性/修飾詞 | 說明 |
|---|---|
extern | 告訴編譯器方法在外部實作 (非 CIL),不可省略。 |
static | P/Invoke 方法必須為 static,因無 this 指標。 |
DllImport | 指定 DLL 檔名、進入點、字元集、呼叫慣例、SetLastError 等。 |
CharSet | Ansi/Unicode/Auto 決定字串封送字元編碼。 |
CallingConvention | 預設 Winapi (Windows 上為 StdCall),C++ DLL 常用 Cdecl。 |
MarshalAs | 參數/回傳值封送細節 (如 LPArray、BStr、CustomMarshaler)。 |
In/Out/InOut | 指定資料流向,優化封送效能。 |
專案同時參考 Lib.v1.dll 與 Lib.v2.dll (兩者類型名稱相同) 時:
v1, v2)。extern alias v1;
extern alias v2;
v1::Namespace.ClassA obj1 = new v1::Namespace.ClassA();
v2::Namespace.ClassA obj2 = new v2::Namespace.ClassA();
CharSet.Auto 在 Windows 上為 Unicode (UTF-16),C++ char* 需指定 CharSet.Ansi 或手動 Marshal.StringToHGlobalAnsi。[StructLayout(LayoutKind.Sequential, Pack=1)] 對齊需與 C++ #pragma pack 一致。CoTaskMemAlloc) 需對應 Marshal.FreeCoTaskMem,或定義 SafeHandle 衍生類封裝。IntPtr 對應原生指標大小,避免用 int 接收指標。GetLastError/HRESULT。extern 是 C# 連結非受控世界的橋樑。掌握 DllImport 完整屬性、封送規則、記憶體管理與組件別名機制,能安全、高效地整合 C/C++ 庫、系統 API 與多版本組件。