如何:使用 P/Invoke 封送嵌入式指针
可以使用平台调用 (P/Invoke) 功能从托管代码调用非托管 DLL 中实现的函数。 如果 DLL 的源代码不可用,则 P/Invoke 是互操作的唯一选项。 但是,与其他 .NET 语言不同,Visual C++ 提供了 P/Invoke 的替代方法。 有关详细信息,请参阅使用 C++ 互操作(隐式 P/Invoke)和如何:使用 C++ 互操作封送嵌入式指针。
示例
将结构传递给本机代码需要创建一个在数据布局方面与本机结构等效的托管结构。 但是,对包含指针的结构需要进行特殊处理。 对于本机结构中的每个嵌入指针,该结构的托管版本应包含 IntPtr 类型的实例。 此外,必须使用 AllocCoTaskMem、StructureToPtr 和 FreeCoTaskMem 方法显式分配、初始化和释放用于这些实例的内存。
以下代码由一个非托管模块和一个托管模块组成。 非托管模块是一个 DLL,用于定义一个函数,该函数接受一个包含指针的 ListString
结构,还有一个名为 TakesListStruct
的函数。
// TraditionalDll6.cpp
// compile with: /EHsc /LD
#include <stdio.h>
#include <iostream>
#define TRADITIONALDLL_EXPORTS
#ifdef TRADITIONALDLL_EXPORTS
#define TRADITIONALDLL_API __declspec(dllexport)
#else
#define TRADITIONALDLL_API __declspec(dllimport)
#endif
#pragma pack(push, 8)
struct ListStruct {
int count;
double* item;
};
#pragma pack(pop)
extern "C" {
TRADITIONALDLL_API void TakesListStruct(ListStruct);
}
void TakesListStruct(ListStruct list) {
printf_s("[unmanaged] count = %d\n", list.count);
for (int i=0; i<list.count; i++)
printf_s("array[%d] = %f\n", i, list.item[i]);
}
托管模块是一个命令行应用程序,用于导入 TakesListStruct
函数并定义一个 MListStruct
结构,该结构与本机 ListStruct
等效,只不过 double*
用 IntPtr 实例表示。 在调用 TakesListStruct
之前,main
函数会分配并初始化此字段引用的内存。
// EmbeddedPointerMarshalling.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;
[StructLayout(LayoutKind::Sequential, Pack=8)]
value struct MListStruct {
int count;
IntPtr item;
};
value struct TraditionalDLL {
[DllImport("TraditionalDLL6.dll")]
static public void TakesListStruct(MListStruct);
};
int main() {
array<double>^ parray = gcnew array<double>(10);
Console::WriteLine("[managed] count = {0}", parray->Length);
Random^ r = gcnew Random();
for (int i=0; i<parray->Length; i++) {
parray[i] = r->NextDouble() * 100.0;
Console::WriteLine("array[{0}] = {1}", i, parray[i]);
}
int size = Marshal::SizeOf(double::typeid);
MListStruct list;
list.count = parray->Length;
list.item = Marshal::AllocCoTaskMem(size * parray->Length);
for (int i=0; i<parray->Length; i++) {
IntPtr t = IntPtr(list.item.ToInt32() + i * size);
Marshal::StructureToPtr(parray[i], t, false);
}
TraditionalDLL::TakesListStruct( list );
Marshal::FreeCoTaskMem(list.item);
}
使用传统 #include
指令不会向托管代码公开 DLL 的任何部分。 事实上,DLL 仅在运行时被访问,因此使用 DllImportAttribute 导入的函数中的问题无法在编译时检测到。