Instrukcje: przeprowadzanie marshalingu wskaźników osadzonych przy użyciu funkcji P/Invoke

Funkcje implementowane w niezarządzanych bibliotekach DLL mogą być wywoływane z kodu zarządzanego przy użyciu funkcji Wywołaj platformę (P/Invoke). Jeśli kod źródłowy biblioteki DLL nie jest dostępny, P/Invoke jest jedyną opcją dla współdziałania. Jednak w przeciwieństwie do innych języków platformy .NET język Visual C++ stanowi alternatywę dla języka P/Invoke. Aby uzyskać więcej informacji, zobacz Using C++ Interop (Implicit P/Invoke) (Używanie międzyoperacyjności języka C++ i Instrukcje: przeprowadzanie marshalingu wskaźników osadzonych przy użyciu międzyoperacyjności języka C++).

Przykład

Przekazywanie struktur do kodu natywnego wymaga utworzenia struktury zarządzanej, która jest równoważna układowi danych do struktury natywnej. Jednak struktury zawierające wskaźniki wymagają specjalnej obsługi. Dla każdego osadzonego wskaźnika w strukturze natywnej zarządzana wersja struktury powinna zawierać wystąpienie IntPtr typu. Ponadto pamięć dla tych wystąpień musi być jawnie przydzielona, zainicjowana i zwolniona przy użyciu AllocCoTaskMemmetod , StructureToPtri FreeCoTaskMem .

Poniższy kod składa się z niezarządzanego i zarządzanego modułu. Moduł niezarządzany to biblioteka DLL, która definiuje funkcję, która akceptuje strukturę o nazwie ListString , która zawiera wskaźnik, oraz funkcję o nazwie 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]);
}

Moduł zarządzany to aplikacja wiersza polecenia, która importuje TakesListStruct funkcję i definiuje strukturę o nazwie MListStruct równoważnej ListStruct natywnej z tą różnicą, że double* element jest reprezentowany przez IntPtr wystąpienie. Przed wywołaniem TakesListStructmain funkcji funkcja przydziela i inicjuje pamięć, do którego odwołuje się to pole.

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

Żadna część biblioteki DLL nie jest uwidaczniona w kodzie zarządzanym przy użyciu tradycyjnej #include dyrektywy. W rzeczywistości biblioteka DLL jest dostępna tylko w czasie wykonywania, więc problemy z funkcjami importowanymi przy użyciu DllImportAttribute polecenia nie mogą być wykrywane w czasie kompilacji.

Zobacz też

Używanie jawnego P/Invoke w języku C++ (DllImport atrybut)