Практическое руководство. Маршалинг массивов с помощью службы PInvoke

  • Статья

Обновлен: Ноябрь 2007

В данном разделе объясняется, как машинные функции, которые принимают строки в стиле языка С, могут вызываться с помощью строкового типа среды CLR String, с помощью поддержки службы P/Invoke .NET Framework. Программистам Visual C++ рекомендуется использовать возможности C++ взаимодействия (когда это возможно), так как вызов P/Invoke предоставляет мало сведений об ошибках во время компиляции, не является строго типизированным и сложен в реализации. Если неуправляемый API упакован как библиотека DLL и исходный код не доступен, служба P/Invoke является единственной доступной возможностью (в противном случае см. раздел Использование взаимодействия языка C++ (неявный PInvoke)).

Пример

Т. к. машинные и управляемые массивы по-разному расположены в памяти, успешная передача их через границу управляемого или неуправляемого кода требует соглашения или маршалинга. В данном разделе показано, как можно передать массив простых (не преобразуемых) элементов от управляемого кода машинным функциям.

Как и в общем случае маршалинга управляемых и неуправляемых данных, атрибуты класса DllImportAttribute используются для создания управляемой точки входа для каждой машинной функции, которая будет использоваться. В отношении функций, которые принимают массивы в качестве аргументов, атрибуты класса MarshalAsAttribute должны использоваться также для указания компилятору способа маршалинга данных. В следующем примере перечисление LPArray используется для указания того, что управляемые массивы будут маршалированы как массивы в стиле С.

В следующем примере кода представлен неуправляемый и управляемый модуль. Неуправляемый модуль — это библиотека DLL, которая определяет функцию, принимающую массив целых чисел. Второй модуль является управляемым приложением командной строки, которое импортирует данную функцию, но определяет ее в терминах управляемого массива, и использует атрибут MarshalAsAttribute для указания того, что массив должен быть конвертирован в машинный массив при вызове.

Управляемый модуль компилируется с помощью параметра/clr, а также допускается использование параметра /clr:pure.

// TraditionalDll4.cpp
// compile with: /LD /EHsc
#include <iostream>

#define TRADITIONALDLL_EXPORTS
#ifdef TRADITIONALDLL_EXPORTS
#define TRADITIONALDLL_API __declspec(dllexport)
#else
#define TRADITIONALDLL_API __declspec(dllimport)
#endif

extern "C" {
   TRADITIONALDLL_API void TakesAnArray(int len, int[]);
}

void TakesAnArray(int len, int a[]) {
   printf_s("[unmanaged]\n");
   for (int i=0; i<len; i++)
      printf("%d = %d\n", i, a[i]);
}

// MarshalBlitArray.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;

value struct TraditionalDLL {
   [DllImport("TraditionalDLL4.dll")]
   static public void TakesAnArray(
   int len,[MarshalAs(UnmanagedType::LPArray)]array<int>^);
};

int main() {
   array<int>^ b = gcnew array<int>(3);
   b[0] = 11;
   b[1] = 33;
   b[2] = 55;
   TraditionalDLL::TakesAnArray(3, b);

   Console::WriteLine("[managed]");
   for (int i=0; i<3; i++)
      Console::WriteLine("{0} = {1}", i, b[i]);
}

Обратите внимание, что в управляемом коде никакие компоненты библиотеки DLL не предоставляются с помощью стандартной директивы #include. Фактически доступ к библиотеке DLL происходит только во время выполнения, поэтому проблем с функциями, импортируемыми с помощью DllImportAttribute во время компиляции не обнаруживаются.

См. также

Другие ресурсы

Использование явного вызова Pinvoke в C++ (атрибут DllImport)