Compartilhar via


Como: matrizes de empacotamento usando PInvoke

Este tópico explica como nativas funções que aceitam seqüências de caracteres de estilo c podem ser chamadas usando o tipo de string do CLR String usando.Suporte de invocação de plataforma do NET Framework.Programadores do Visual C++ são incentivados a usar os recursos de interoperabilidade de C++ em vez disso (quando possível) porque P/Invoke fornece relatórios de erro em tempo de compilar pouco, não é tipo seguro e pode ser entediante implementar.Se a API não gerenciada é empacotada como uma DLL e o código-fonte não está disponível, P/Invoke é a única opção (caso contrário, consulte Usando interoperabilidade C++ (PInvoke implícita)).

Exemplo

Como matrizes nativos e gerenciados são dispostas diferente na memória, passar-os com êxito entre o limite gerenciado/exige conversão ou empacotamento.Este tópico demonstra como uma matriz de itens simples (blitable) pode ser passada para funções nativas do código gerenciado.

Como é verdadeiro de empacotamento de dados gerenciados/não gerenciados em geral, o DllImportAttribute atributo é usado para criar um ponto de entrada gerenciado para cada função nativa que será usado.No caso de funções que levam matrizes como argumentos, o MarshalAsAttribute atributo deve ser usado também para especificar para o compilador como os dados serão empacotados.No exemplo a seguir, o LPArray enumeração é usada para indicar que o array gerenciado será empacotado como uma matriz estilo C.

O código a seguir consiste em uma não gerenciado e um módulo gerenciado.O módulo não gerenciado é uma DLL que define uma função que aceita uma matriz de inteiros.O segundo módulo é um aplicativo gerenciado de linha de comando que importa essa função, mas define em termos de uma matriz gerenciada e usa o MarshalAsAttribute atributo para especificar que a matriz deve ser convertida em uma matriz nativa quando chamado.

O módulo gerenciado é compilado com /clr, mas /clr: pura funciona bem.

// 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]);
}

Observe que nenhuma parte da DLL é exposto para código gerenciado por meio do tradicional # incluir diretiva.Na verdade, porque a DLL é acessada no tempo de execução somente, problemas com funções importados com DllImportAttribute não serão detectados em tempo de compilação.

Consulte também

Outros recursos

Usando PInvoke Explicit no C++ (atributo DllImport)