Yönetilen Koddan Yerel İşlevleri Çağırma

Ortak dil çalışma zamanı, yönetilen kodun yerel dinamik bağlantı kitaplıklarında (DLL'ler) C stili işlevleri çağırmasına imkan tanıyan Platform Çağırma Hizmetleri veya PInvoke sağlar.Aynı veri sıralama, çalışma zamanıyla COM birlikte çalışabilirlik için ve "It Just Works" öğesi veya IJW, mekanizma için kullanılır.

Daha fazla bilgi için bkz:

• C++'ta Açık PInvoke Kullanma (DllImport Özniteliği)

• C++ Birlikte Çalışabilirliği Kullanma (Örtük PInvoke)

• Platform Çağırmaya Daha Yakından Bakış

Bu bölümdeki örnekler sadece PInvoke öğesinin kullanımını gösterir.Yordam sıralama kodu yazmak yerine sıralama bilgilerini bildirimli olarak öznitelikler yoluyla sağladığınızdan PInvoke, özelleştirilmiş veri sıralamasını basitleştirebilir.

[!NOT]

Sıralama kitaplığı, en iyi duruma getirilmiş şekilde yerel ve yönetilen ortamlar arasında veri sıralamanın alternatif bir yolunu sağlar.Sıralama kitaplığı hakkında daha fazla bilgi için bkz. C++'da Sıralamaya Genel Bakış.Sıralama kitaplığı işlevler için değil yalnızca veriler için kullanılabilir.

PInvoke ve DllImport Özniteliği

Aşağıdaki örnek bir Visual C++ programında PInvoke öğesinin kullanımını gösterir.Yerel işlev giriş/çıkışları msvcrt.dll'de tanımlanır.DllImport özniteliği giriş/çıkış bildirimi için kullanılır.

// platform_invocation_services.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;

[DllImport("msvcrt", CharSet=CharSet::Ansi)]
extern "C" int puts(String ^);

int main() {
   String ^ pStr = "Hello World!";
   puts(pStr);
}

Aşağıdaki örnek, önceki örneğe eşdeğerdir, ancak IJW kullanır.

// platform_invocation_services_2.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;

#include <stdio.h>

int main() {
   String ^ pStr = "Hello World!";
   char* pChars = (char*)Marshal::StringToHGlobalAnsi(pStr).ToPointer(); 
   puts(pChars);
   
   Marshal::FreeHGlobal((IntPtr)pChars);
}

IJW avantajları

• Programın kullandığı yönetilmeyen API'lara ilişkin DLLImport öznitelik bildirimlerini yazmaya gerek yoktur.Üstbilgi dosyasını ve bağlantıyı içe aktarma kitaplığıyla birlikte ekleyin.

• IJW mekanizması biraz daha hızlıdır (örneğin, IJW saplamalarının veri öğelerini sabitlemesi veya kopyalaması gerekmez çünkü bunlar açıkça geliştirici tarafından yapılır).

• Performans sorunlarını açıkça gösterir.Bu durumda, aslında bir Unicode dizesini bir ANSI dizesine çeviriyorsunuz ve görevli bellek ayırmaya ve ayırmayı kaldırmaya sahipsiniz.Bu durumda, IJW kullanarak kodu yazan geliştirici _putws ve PtrToStringChars öğesini çağırmanın performans için daha iyi olacağını görecektir.

• Aynı veriyi kullanarak birçok yönetilmeyen API çağırırsanız, bunu bir kez hazırlamak ve hazırlanmış kopyayı geçirmek, her seferinde yeniden hazırlamaktan çok daha fazla verimlidir.

IJW Dezavantajları

• Sıralama, öznitelikler (çoğu zaman uygun varsayılanlara sahiptir) tarafından değil, kod içinde açıkça belirtilmelidir.

• Sıralama kodu uygulama mantığının akışında daha bozucu olduğu satır içidir.

• Açık sıralama API'ları 32-bit ila 64-bit taşınabilirlik için IntPtr türlerini döndürdüğünden, ek ToPointer çağrıları kullanmanız gerekir.

C++ tarafından sunulan belirli yöntem, bazı ek karmaşıklıklar içerir ancak daha etkin ve açık bir yöntemdir.

Uygulama ağırlıklı olarak yönetilmeyen veri türleri kullanıyorsa veya .NET Framework API'larından daha fazla yönetilmeyen API'ları çağırıyorsa, IJW özelliğini kullanmanızı öneririz.Çoğunlukla yönetilen uygulamada nadiren yönetilmeyen API çağırmak için gereken seçim daha inceliklidir.

Windows API'ları içeren PInvoke

PInvoke, Windows'daki işlevleri çağırmak için uygundur.

Bu örnekte, bir Visual C++ programı Win32 API'sının parçası olan MessageBox işleviyle birlikte çalışır.

// platform_invocation_services_4.cpp
// compile with: /clr /c
using namespace System;
using namespace System::Runtime::InteropServices;
typedef void* HWND;
[DllImport("user32", CharSet=CharSet::Ansi)]
extern "C" int MessageBox(HWND hWnd, String ^ pText, String ^ pCaption, unsigned int uType);

int main() {
   String ^ pText = "Hello World! ";
   String ^ pCaption = "PInvoke Test";
   MessageBox(0, pText, pCaption, 0);
}

Çıktı, PInvoke Testi başlığına sahip olan ve Hello World! metnini içeren bir ileti kutusudur.

Sıralama bilgileri DLL'deki işlevleri aramak için PInvoke tarafından da kullanılır.user32.dll öğesinde aslında MessageBox işlevi yoktur, ancak CharSet=CharSet::Ansi PInvoke'un Unicode sürümü olan MessageBoxW yerine ANSI sürümü olan MessageBoxA öğesini kullanmasına olanak verir.Genel olarak, .NET Framework dize nesnelerinin yerel Unicode biçimlerini ANSI öğesine çevirme yükünü ortadan kaldıracağından yönetilmeyen API'ların Unicode sürümlerini kullanmanızı öneririz.

PInvoke Ne Zaman Kullanılmaz?

PInvoke kullanma, DLL'lerdeki tüm C-stili işlevler için uygun değildir.Örneğin, aşağıdaki gibi belirtilen bir mylib.dll içinde bir MakeSpecial işlevinin bulunduğunu varsayın:

char * MakeSpecial(char * pszString);

Visual C++ uygulamasında PInvoke işlevini kullanırsak, aşağıdakine benzer bir şey yazabiliriz:

[DllImport("mylib")]

extern "C" String * MakeSpecial([MarshalAs(UnmanagedType::LPStr)] String ^);

Buradaki zorluk MakeSpecial tarafından döndürülen yönetilmeyen dize için belleği silemememizdir.PInvoke aracılığıyla çağrılan diğer işlevler kullanıcı tarafından kaldırılması gerekmeyen dahili arabelleğe ilişkin bir işaretçi döndürür.Bu durumda belirgin seçim, IJW özelliğini kullanmaktır.

PInvoke Sınırlamaları

Parametre olarak aldığınız yerel bir işlevden işaretçinin aynısını döndüremezsiniz.Yerel bir işlev PInvoke tarafından kendisine sıralanmış işaretçiyi döndürürse, bellek bozulması ve özel durumlar oluşması beklenebilir.

__declspec(dllexport)
char* fstringA(char* param) {
   return param;
}

Aşağıdaki örnek bu sorunu gösterir ve program doğru çıktıyı veriyor gibi görünse bile çıktı serbest bırakılan bellekten gelmektedir.

// platform_invocation_services_5.cpp
// compile with: /clr /c
using namespace System;
using namespace System::Runtime::InteropServices;
#include <limits.h>

ref struct MyPInvokeWrap {
public:
   [ DllImport("user32.dll", EntryPoint = "CharLower", CharSet = CharSet::Ansi) ]
   static String^ CharLower([In, Out] String ^);
};

int main() {
   String ^ strout = "AabCc";
   Console::WriteLine(strout);
   strout = MyPInvokeWrap::CharLower(strout);
   Console::WriteLine(strout);
}

Bağımsız Değişkenleri Sıralama

PInvoke ile aynı forma sahip yönetilen ve C++ yerel temel türler arasında sıralamaya gerek yoktur.Örneğin, Int32 ve int arasında veya Double ve double arasında herhangi bir sıralama yapılması gerekmez.

Ancak, aynı forma sahip olmayan türleri sıralamanız gerekir.Bu; char, string ve struct türlerini içerir.Aşağıdaki tablo, çeşitli türler için sıralayıcı tarafından kullanılan eşlemeleri gösterir:

Adresi yönetilmeyen bir işleve geçirilirse sıralayıcı otomatik olarak çalışma zamanı yığınına ayrılmış belleği sabitler.Sabitleme, çöp toplayıcısının ayrılan bellek bloğunu sıkıştırma sırasında taşımasını engeller.

Bu konunun önceki bölümlerinde gösterilen örnekte, DllImport öğesinin CharSet parametresi yönetilen Dizeler'in nasıl sıralanması gerektiğini belirtir; bu durumda bunlar yerel taraf için ANSI dizelerine sıralanmalıdır.

MarshalAs özniteliğini kullanılarak bir yerel işlevin tek tek bağımsız değişkenlerinin sıralama bilgilerini belirtebilirsiniz.Bir String * bağımsız değişkenini sıralamak için birkaç seçenek vardır: BStr, ANSIBStr, TBStr, LPStr, LPWStr ve LPTStr.Varsayılan, LPStr'dir.

Bu örnekte, dize çift baytlık Unicode karakter dizesi, LPWStr olarak sıralanır.Çıktı Hello World!'ün ilk harfidir çünkü sıralanmış dizenin ikinci baytı null'dur ve puts bunu bir dize sonu işareti olarak yorumlar.

// platform_invocation_services_3.cpp
// compile with: /clr
using namespace System;
using namespace System::Runtime::InteropServices;

[DllImport("msvcrt", EntryPoint="puts")]
extern "C" int puts([MarshalAs(UnmanagedType::LPWStr)] String ^);

int main() {
   String ^ pStr = "Hello World!";
   puts(pStr);
}

MarshalAs özniteliği System::Runtime::InteropServices ad alanındadır.Öznitelik, diziler gibi diğer veri türleri ile kullanılabilir.

Bu konuda daha önce belirtildiği gibi sıralama kitaplığı, yerel ve yönetilen ortamlar arasında verileri sıralamak için yeni, en iyi duruma getirilmiş bir yöntem sağlar.Daha fazla bilgi için bkz. C++'da Sıralamaya Genel Bakış.

Performans Değerlendirmeleri

PInvoke, çağrı başına 10 ila 30 x86 yönergeleri yüküne sahiptir.Bu sabit maliyete ek olarak, sıralama ek yük oluşturur.Yönetilen ve yönetilmeyen kod içinde aynı gösterimi içeren taşınabilir türler arasında hiçbir sıralama maliyeti yoktur.Örneğin, int ve Int32 arasında dönüştürme maliyeti yoktur.

Daha iyi performans için, çağrı başına daha az veri sıralayan daha fazla çağrı yerine, mümkün olan en fazla veriyi sıralayan daha az PInvoke çağrısına sahip olun.

Ayrıca bkz.

Diğer Kaynaklar

Yerel ve.NET Birlikte Çalışabilirliği