Como: realizar realizar marshaling Callbacks e delegados usando interoperabilidade C++

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

Os exemplos de código a seguir usam o gerenciado, não gerenciado para implementar as diretivas # pragma gerenciado e funções não gerenciadas no mesmo arquivo, mas as funções também podem ser definida em arquivos separados. Arquivos que contêm somente funções não gerenciadas não precisam ser compilado com o o CLR (ComComummon Idioma Tempo de execução ComComumpilation).

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, é usado para recuperar o ponto de entrada base para o delegado. Esse endereço é então passado para a desinstalação gerenciado função, que faz a chamada sem conhecimento do fato de que ele é implementado sistema autônomo um gerenciado função.

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

Se um delegado é re-located por um lixo coleção, isso não afetará o retorno de chamada underlaying gerenciado, caso Alloc é usado para adicionar uma referência ao delegado, permitindo a realocação do representante, mas impedindo o descarte. O uso de 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 nesse caso o ponteiro de função fornecida é armazenado pela API não gerenciada, para que ele pode ser chamado a qualquer momento, exigindo a coleta de lixo ser individualmente suprimidas por um período de time arbitrário.sistema autônomo resultado, o exemplo a seguir usa uma instância global de GCHandle Para impedir que o delegado sendo realocados, independente do escopo de função. Conforme discutido no primeiro exemplo, usando pin_ptr é desnecessário para esses exemplos, mas nesse caso funcionariam assim mesmo, sistema autônomo o escopo de um pin_ptr está 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 a interoperabilidade de C++ (PInvoke implícita)