Como realizar marshaling de matrizes usando interop C++

Este tópico demonstra uma faceta da interoperabilidade do Visual C++. Para obter mais informações, confira Usando a interoperabilidade do C++ (PInvoke Implícito).

Os exemplos de código a seguir usam as diretivas de #pragma managed, unmanaged para implementar funções gerenciadas e não gerenciadas no mesmo arquivo, mas essas funções interoperam da mesma maneira se definidas em arquivos separados. Os arquivos que contêm apenas funções não gerenciadas não precisam ser compilados com /clr (compilação do Common Language Runtime).

Exemplo: passar a matriz gerenciada para a função não gerenciada

O exemplo a seguir demonstra como passar uma matriz gerenciada para uma função não gerenciada. A função gerenciada usa pin_ptr (C++/CLI) para suprimir a coleta de lixo da matriz antes de chamar a função não gerenciada. Ao fornecer a função não gerenciada com um ponteiro fixado no heap do GC, a sobrecarga de fazer uma cópia da matriz pode ser evitada. Para demonstrar que a função não gerenciada está acessando a memória de heap do GC, ela modifica o conteúdo da matriz e as alterações são refletidas quando a função gerenciada retoma o controle.

// PassArray1.cpp
// compile with: /clr
#ifndef _CRT_RAND_S
#define _CRT_RAND_S
#endif

#include <iostream>
#include <stdlib.h>
using namespace std;

using namespace System;

#pragma unmanaged

void TakesAnArray(int* a, int c) {
   cout << "(unmanaged) array received:\n";
   for (int i=0; i<c; i++)
      cout << "a[" << i << "] = " << a[i] << "\n";

   unsigned int number;
   errno_t err;

   cout << "(unmanaged) modifying array contents...\n";
   for (int i=0; i<c; i++) {
      err = rand_s( &number );
      if ( err == 0 )
         a[i] = number % 100;
   }
}

#pragma managed

int main() {
   array<int>^ nums = gcnew array<int>(5);

   nums[0] = 0;
   nums[1] = 1;
   nums[2] = 2;
   nums[3] = 3;
   nums[4] = 4;

   Console::WriteLine("(managed) array created:");
   for (int i=0; i<5; i++)
      Console::WriteLine("a[{0}] = {1}", i, nums[i]);

   pin_ptr<int> pp = &nums[0];
   TakesAnArray(pp, 5);

   Console::WriteLine("(managed) contents:");
   for (int i=0; i<5; i++)
      Console::WriteLine("a[{0}] = {1}", i, nums[i]);
}

Exemplo: passar a matriz não gerenciada para a função gerenciada

O exemplo a seguir demonstra a passagem de uma matriz não gerenciada para uma função gerenciada. A função gerenciada acessa a memória da matriz diretamente (em vez de criar uma matriz gerenciada e copiar o conteúdo da matriz), o que permite que as alterações feitas pela função gerenciada sejam refletidas na função não gerenciada quando ela recupera o controle.

// PassArray2.cpp
// compile with: /clr
#include <iostream>
using namespace std;

using namespace System;

#pragma managed

void ManagedTakesAnArray(int* a, int c) {
   Console::WriteLine("(managed) array received:");
   for (int i=0; i<c; i++)
      Console::WriteLine("a[{0}] = {1}", i, a[i]);

   cout << "(managed) modifying array contents...\n";
   Random^ r = gcnew Random(DateTime::Now.Second);
   for (int i=0; i<c; i++)
      a[i] = r->Next(100);
}

#pragma unmanaged

void NativeFunc() {
   int nums[5] = { 0, 1, 2, 3, 4 };

   printf_s("(unmanaged) array created:\n");
   for (int i=0; i<5; i++)
      printf_s("a[%d] = %d\n", i, nums[i]);

   ManagedTakesAnArray(nums, 5);

   printf_s("(ummanaged) contents:\n");
   for (int i=0; i<5; i++)
      printf_s("a[%d] = %d\n", i, nums[i]);
}

#pragma managed

int main() {
   NativeFunc();
}

Confira também

Usando interop do C++ (PInvoke implícito)