Como: Retornos de chamada de empacotamento e delegados usando a interoperabilidade de C++

Este tópico demonstra o marshalling dos retornos de chamada e delega o (a versão de um retorno de chamada gerenciada) entre código gerenciado e usando o Visual C++.

O código a seguir exemplos de uso do managed, unmanaged diretivas # pragma implementar gerenciados e funções não gerenciadas no mesmo arquivo, mas as funções também poderiam ser definido em arquivos separados. Arquivos contendo apenas as funções não gerenciadas não precisam ser compilado com o /CLR (common Language Runtime Compilation).

Exemplo

O exemplo a seguir demonstra como configurar uma API não gerenciada para acionar um delegado gerenciado. Um delegado gerenciado é criado e um dos métodos de interoperabilidade, GetFunctionPointerForDelegate, que é usado para recuperar o ponto de entrada de base para o delegado. Esse endereço é então passado para a função não gerenciada, que chama a sem conhecimento do fato de que ele é implementado como uma função gerenciada.

Observe que é possível, mas não necessário, pin o delegado usando pin_ptr para impedir que sejam re-located ou descartado pelo coletor de lixo. Proteção contra a coleta de lixo prematuro é necessária, mas a fixação oferece mais proteção do que é necessário, pois ele impede que a coleção, mas também impede a realocação.

Se um delegado é re-located por uma coleta de lixo, isso não afetará o retorno de chamada subjacentes gerenciados, portanto, Alloc é usado para adicionar uma referência ao delegado, permitindo a realocação do delegado, mas impedindo alienação. Usando o GCHandle em vez de pin_ptr reduz a possibilidade de fragmentação da heap gerenciada.

// MarshalDelegate1.cpp
// compile with: /clr
#include <iostream>

using namespace System;
using namespace System::Runtime::InteropServices;

#pragma unmanaged

// Declare an unmanaged function type that takes two int arguments
// Note the use of __stdcall for compatibility with managed code
typedef int (__stdcall *ANSWERCB)(int, int);

int TakesCallback(ANSWERCB fp, int n, int m) {
   printf_s("[unmanaged] got callback address, calling it...\n");
   return fp(n, m);
}

#pragma managed

public delegate int GetTheAnswerDelegate(int, int);

int GetNumber(int n, int m) {
   Console::WriteLine("[managed] callback!");
   return n + m;
}

int main() {
   GetTheAnswerDelegate^ fp = gcnew GetTheAnswerDelegate(GetNumber);
   GCHandle gch = GCHandle::Alloc(fp);
   IntPtr ip = Marshal::GetFunctionPointerForDelegate(fp);
   ANSWERCB cb = static_cast<ANSWERCB>(ip.ToPointer());
   Console::WriteLine("[managed] sending delegate as callback...");

// force garbage collection cycle to prove
// that the delegate doesn't get disposed
   GC::Collect();

   int answer = TakesCallback(cb, 243, 257);

// release reference to delegate
   gch.Free();
}

O exemplo a seguir é semelhante ao exemplo anterior, mas nesse caso o ponteiro de função fornecida é armazenado pela API não gerenciada, portanto, ele pode ser chamado a qualquer momento, exigindo que coleta de lixo suprimidas por um período arbitrário. Como resultado, o exemplo a seguir usa uma instância global da GCHandle para impedir que o delegado sejam realocados, independente do escopo de função. Conforme discutido no primeiro exemplo, usando o pin_ptr é desnecessário para esses exemplos, mas nesse caso funcionariam assim mesmo, o escopo de um pin_ptr é limitado a uma única função.

// MarshalDelegate2.cpp
// compile with: /clr 
#include <iostream>

using namespace System;
using namespace System::Runtime::InteropServices;

#pragma unmanaged

// Declare an unmanaged function type that takes two int arguments
// Note the use of __stdcall for compatibility with managed code
typedef int (__stdcall *ANSWERCB)(int, int);
static ANSWERCB cb;

int TakesCallback(ANSWERCB fp, int n, int m) {
   cb = fp;
   if (cb) {
      printf_s("[unmanaged] got callback address (%d), calling it...\n", cb);
      return cb(n, m);
   }
   printf_s("[unmanaged] unregistering callback");
   return 0;
}

#pragma managed

public delegate int GetTheAnswerDelegate(int, int);

int GetNumber(int n, int m) {
   Console::WriteLine("[managed] callback!");
   static int x = 0;
   ++x;

   return n + m + x;
}

static GCHandle gch;

int main() {
   GetTheAnswerDelegate^ fp = gcnew GetTheAnswerDelegate(GetNumber);

   gch = GCHandle::Alloc(fp);

   IntPtr ip = Marshal::GetFunctionPointerForDelegate(fp);
   ANSWERCB cb = static_cast<ANSWERCB>(ip.ToPointer());
   Console::WriteLine("[managed] sending delegate as callback...");

   int answer = TakesCallback(cb, 243, 257);

   // possibly much later (in another function)...

   Console::WriteLine("[managed] releasing callback mechanisms...");
   TakesCallback(0, 243, 257);
   gch.Free();
}

Consulte também

Referência

Usar a interoperabilidade de C++ (PInvoke implícito)