Partilhar via


Como fazer: Agrupar ponteiros embutidos usando P/Invoke

As funções implementadas em DLLs não gerenciadas podem ser chamadas a partir do código gerenciado usando a funcionalidade Platform Invoke (P/Invoke). Se o código-fonte da DLL não estiver disponível, P/Invoke será a única opção para interoperar. No entanto, ao contrário de outras linguagens .NET, Visual C++ fornece uma alternativa para P/Invoke. Para obter mais informações, consulte Usando Interoperabilidade C++ (P/Invoke Implícito) e Como marshalar ponteiros embutidos usando Interoperabilidade C++.

Exemplo

Passar estruturas para código nativo requer que uma estrutura gerenciada que seja equivalente em termos de layout de dados à estrutura nativa seja criada. No entanto, as estruturas que contêm ponteiros requerem um manuseamento especial. Para cada ponteiro incorporado na estrutura nativa, a versão gerenciada da estrutura deve conter uma instância do IntPtr tipo. Além disso, a memória para essas instâncias deve ser explicitamente alocada, inicializada e liberada usando os AllocCoTaskMemmétodos , StructureToPtre FreeCoTaskMem .

O código a seguir consiste em um módulo não gerenciado e um módulo gerenciado. O módulo não gerenciado é uma DLL que define uma função que aceita uma estrutura chamada ListString que contém um ponteiro e uma função chamada 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]);
}

O módulo gerenciado é um aplicativo de linha de comando que importa a TakesListStruct função e define uma estrutura chamada MListStruct que é equivalente à nativa ListStruct , exceto que a double* é representada com uma IntPtr instância. Antes de chamar TakesListStruct, a main função aloca e inicializa a memória à qual esse campo faz referência.

// 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);
}

Nenhuma parte da DLL é exposta ao código gerenciado usando a diretiva tradicional #include . Na verdade, a DLL é acessada apenas em tempo de execução, portanto, problemas em funções importadas usando DllImportAttribute não podem ser detetados em tempo de compilação.

Ver também

Usando P/Invoke explícito em C++ (DllImport atributo )