平台调用 (P/Invoke)Platform Invoke (P/Invoke)
- 本文内容
从非托管代码调用托管代码Invoking managed code from unmanaged code
更多资源More resources

平台调用 (P/Invoke)Platform Invoke (P/Invoke)

本文内容

P/Invoke 是可用于从托管代码访问非托管库中的结构、回调和函数的一种技术。大多数 P/Invoke API 包含在以下两个命名空间中：System 和 System.Runtime.InteropServices。使用这两个命名空间可提供用于描述如何与本机组件通信的工具。

我们从最常见的示例着手。该示例在托管代码中调用非托管函数。让我们从命令行应用程序显示一个消息框：

using System.Runtime.InteropServices;
public class Program {
    // Import user32.dll (containing the function we need) and define
    // the method corresponding to the native function.
    [DllImport("user32.dll")]
    public static extern int MessageBox(IntPtr hWnd, String text, String caption, int options);
    public static void Main(string[] args) {
        // Invoke the function as a regular managed method.
        MessageBox(IntPtr.Zero, "Command-line message box", "Attention!", 0);
    }
}

上述示例非常简单，但确实演示了从托管代码调用非托管函数所需执行的操作。让我们逐步分析该示例：

第 1 行显示 System.Runtime.InteropServices 命名空间（用于保存全部所需项）的 using 语句。
第 7 行引入 DllImport 属性。此特性至关重要，因为它告诉运行时要加载非托管 DLL。传入的字符串是目标函数所在的 DLL。
第 8 行显示了 P/Invoke 的关键作用。它定义了一个托管方法，该方法的签名与非托管方法完全相同。可以看到，声明中包含一个新关键字 extern，告诉运行时这是一个外部方法。调用该方法时，运行时应在 DllImport 特性中指定的 DLL 内查找该方法。
该示例的剩余部分无非就是调用该方法，就像调用其他任何托管方法一样。

在 macOS 上也可以使用类似的示例。需要更改 DllImport 属性中的库名称，因为 macOS 使用不同的方案来命名动态库。下面的示例使用 getpid(2) 函数获取应用程序的进程 ID，然后控制台上列显该 ID：

using System;
using System.Runtime.InteropServices;
namespace PInvokeSamples {
    public static class Program {
        // Import the libSystem shared library and define the method corresponding to the native function.
        [DllImport("libSystem.dylib")]
        private static extern int getpid();
        public static void Main(string[] args){
            // Invoke the function and get the process ID.
            int pid = getpid();
            Console.WriteLine(pid);
        }
    }
}

它在 Linux 上也是类似的。函数名称相同，因为 getpid(2) 是标准 POSIX 系统调用。

using System;
using System.Runtime.InteropServices;
namespace PInvokeSamples {
    public static class Program {
        // Import the libc shared library and define the method corresponding to the native function.
        [DllImport("libc.so.6")]
        private static extern int getpid();
        public static void Main(string[] args){
            // Invoke the function and get the process ID.
            int pid = getpid();
            Console.WriteLine(pid);
        }
    }
}

从非托管代码调用托管代码Invoking managed code from unmanaged code

运行时允许通信流量双向流通，这样，便可以使用函数指针从本机函数回调托管代码。在托管代码中，与函数指针最接近的功能就是委托，正是凭借这个功能，才能从本机代码回调托管代码。

此功能的使用方式类似于上面所述的从托管代码调用本机进程。对于给定的回调，需要定义一个与签名匹配的委托，并将其传入外部方法。运行时将负责处理所有剩余工作。

using System;
using System.Runtime.InteropServices;
namespace ConsoleApplication1 {
    class Program {
        // Define a delegate that corresponds to the unmanaged function.
        delegate bool EnumWC(IntPtr hwnd, IntPtr lParam);
        // Import user32.dll (containing the function we need) and define
        // the method corresponding to the native function.
        [DllImport("user32.dll")]
        static extern int EnumWindows(EnumWC lpEnumFunc, IntPtr lParam);
        // Define the implementation of the delegate; here, we simply output the window handle.
        static bool OutputWindow(IntPtr hwnd, IntPtr lParam) {
            Console.WriteLine(hwnd.ToInt64());
            return true;
        }
        static void Main(string[] args) {
            // Invoke the method; note the delegate as a first parameter.
            EnumWindows(OutputWindow, IntPtr.Zero);
        }
    }
}

在演练示例之前，最好是回顾一下所要使用的非托管函数的签名。要调用以枚举所有窗口的函数具有以下签名：BOOL EnumWindows (WNDENUMPROC lpEnumFunc, LPARAM lParam);

第一个参数是回调。该回调具有以下签名：BOOL CALLBACK EnumWindowsProc (HWND hwnd, LPARAM lParam);

现在，让我们来演练示例：

示例中的第 9 行定义与非托管代码中回调签名匹配的委托。请注意如何在托管代码中使用 IntPtr 表示 LPARAM 和 HWND 类型。
第 13 和 14 行从 user32.dll 库中引入 EnumWindows 函数。
第 17 - 20 行实现该委托。在这个简单的示例中，我们只要将句柄输出到控制台。
最后，第 24 行调用外部方法并传入委托。
下面显示了 Linux 和 macOS 示例。在这些平台上，我们可以使用 C 库 libc 中的 ftw 函数。此函数用于遍历目录层次结构，它使用指向某个函数的指针作为其参数之一。该函数具有以下签名：int (fn) (const char fpath, const struct stat *sb, int typeflag)。

using System;
using System.Runtime.InteropServices;
namespace PInvokeSamples {
    public static class Program {
            // Define a delegate that has the same signature as the native function.
            delegate int DirClbk(string fName, StatClass stat, int typeFlag);
            // Import the libc and define the method to represent the native function.
            [DllImport("libc.so.6")]
            static extern int ftw(string dirpath, DirClbk cl, int descriptors);
            // Implement the above DirClbk delegate;
            // this one just prints out the filename that is passed to it.
            static int DisplayEntry(string fName, StatClass stat, int typeFlag) {
                    Console.WriteLine(fName);
                    return 0;
            }
            public static void Main(string[] args){
                    // Call the native function.
                    // Note the second parameter which represents the delegate (callback).
                    ftw(".", DisplayEntry, 10);
            }
    }
    // The native callback takes a pointer to a struct. The below class
    // represents that struct in managed code. You can find more information
    // about this in the section on marshalling below.
    [StructLayout(LayoutKind.Sequential)]
    public class StatClass {
            public uint DeviceID;
            public uint InodeNumber;
            public uint Mode;
            public uint HardLinks;
            public uint UserID;
            public uint GroupID;
            public uint SpecialDeviceID;
            public ulong Size;
            public ulong BlockSize;
            public uint Blocks;
            public long TimeLastAccess;
            public long TimeLastModification;
            public long TimeLastStatusChange;
    }
}

macOS 示例使用相同的函数，唯一的差别在于 DllImport 特性的自变量，因为 macOS 将 libc 保留在不同的位置。

using System;
using System.Runtime.InteropServices;
namespace PInvokeSamples {
        public static class Program {
                // Define a delegate that has the same signature as the native function.
                delegate int DirClbk(string fName, StatClass stat, int typeFlag);
                // Import the libc and define the method to represent the native function.
                [DllImport("libSystem.dylib")]
                static extern int ftw(string dirpath, DirClbk cl, int descriptors);
                // Implement the above DirClbk delegate;
                // this one just prints out the filename that is passed to it.
                static int DisplayEntry(string fName, StatClass stat, int typeFlag) {
                        Console.WriteLine(fName);
                        return 0;
                }
                public static void Main(string[] args){
                        // Call the native function.
                        // Note the second parameter which represents the delegate (callback).
                        ftw(".", DisplayEntry, 10);
                }
        }
        // The native callback takes a pointer to a struct. The below class
        // represents that struct in managed code.
        [StructLayout(LayoutKind.Sequential)]
        public class StatClass {
                public uint DeviceID;
                public uint InodeNumber;
                public uint Mode;
                public uint HardLinks;
                public uint UserID;
                public uint GroupID;
                public uint SpecialDeviceID;
                public ulong Size;
                public ulong BlockSize;
                public uint Blocks;
                public long TimeLastAccess;
                public long TimeLastModification;
                public long TimeLastStatusChange;
        }
}

上面两个示例都依赖于参数，在这两种情况下，参数是作为托管类型提供的。运行时将采取“适当的措施”，在另一个平台上将这些代码处理成等效的代码。类型封送页介绍了如何将类型封送到本机代码。

平台调用 (P/Invoke)

平台调用 (P/Invoke)Platform Invoke (P/Invoke)

本文内容

从非托管代码调用托管代码Invoking managed code from unmanaged code

更多资源More resources