Como: empacotar retornos de chamada e delegados usando interoperabilidade de C++

Este tópico demonstra o empacotamento de retornos de chamada e delega (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 de gerenciado, não gerenciado diretivas # pragma para implementar e gerenciados funções no mesmo arquivo, mas as funções também poderiam ser definidas em arquivos separados.Arquivos que contêm somente funções não gerenciadas não precisará 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 interoperabilidade, GetFunctionPointerForDelegate, é usado para recuperar o ponto de entrada subjacente para o delegado.Esse endereço é então passado para a função não gerenciada, que chama sem conhecimento do fato de que ele é implementado como uma função gerenciada.

Observe que é possível, mas não necessário, para o pino delegado usando pin_ptr (C++/CLI) para impedir que ele seja re-located ou descartado pelo coletor de lixo.Proteção contra lixo prematuro é necessária, mas fixação fornece mais proteção do que é necessário, pois impede que a coleção, mas também impede a realocação.

Se um delegado é re-located por uma coleta de lixo, ele não afetará o retorno de chamada subjacentes gerenciados, assim, Alloc é usado para adicionar uma referência ao delegado, permitindo a realocação do delegado, mas impedindo a alienação.Usar GCHandle em vez de pin_ptr reduz o potencial 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 neste caso o ponteiro de função fornecido é 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 do GCHandle para impedir que o delegado sendo realocados, independentemente do escopo da função.Como discutido no primeiro exemplo, usando pin_ptr é desnecessário para esses exemplos, mas neste caso funcionariam mesmo assim, 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

Usando interoperabilidade C++ (PInvoke implícita)