MarkProfile

Makale
02/26/2013

Bu MarkProfile yöntemi .vsp dosyasına profil işareti ekler.İş parçacığı içeren için profil oluşturmak için MarkProfile işlevinin eklenecek işaret için AÇIK olması gerekir.

PROFILE_COMMAND_STATUS PROFILERAPI MarkProfile( long lMarker );

Parametreler

lMarker

Eklemek için işaretçi.İşaretçinin değeri 0(sıfır)'a eşit veya sıfırdan büyük olmalıdır.

Özellik Değeri ve Dönüş Değeri

Fonksiyon PROFILE_COMMAND_STATUS numaralandırıcı kullanarak başarı veya başarısızlık belirtir.Dönüş değeri aşağıdakilerden biri olabilir:

Numaralandırıcı	Tanımlama
MARK_ERROR_MARKER_RESERVED	Parametre 0'a eşit veya daha az olur.Bu değerler ayrılmıştır.İşaret ve yorum kaydedilmez.
MARK_ERROR_MODE_NEVER	Fonksiyon çağrıldığı zaman profil oluşturma modu HİÇ olarak ayarlandı.İşaret ve yorum kaydedilmez.
MARK_ERROR_MODE_OFF	İşlev çağrıldığında profil oluşturma modu KAPALI olarak ayarlandı.İşaret ve yorum kaydedilmez.
MARK_ERROR_NO_SUPPORT	Bu bağlamda işaret desteği yoktur.İşaret ve yorum kaydedilmez.
MARK_ERROR_OUTOFMEMORY	Olayı kaydetmek için bellek uygun değildi.İşaret ve yorum kaydedilmez.
MARK_TEXTTOOLONG	Dize maksimum 256 karakter sınırını aşıyor.Açıklama dizesi kesilir ve işaret ve yorum kaydedilir.
MARK_OK	MARK_OK, başarılı olduğunu belirtmek için döndürülür.

Notlar

İş parçacığı profil oluşturulmuş MarkProfile işlevini içeriyorsa işaret değeri kod her çalıştığında .vsp dosyasına eklenir.Birden çok kez MarkProfile çağırabilirsiniz.

Profil işaretleri genel kapsam içindedir.Örneğin, profil işareti eklenmiş bir iş parçacığı herhangi bir .vsp dosyasının herhangi bir iş parçacığında veri segmentinin başlangıç veya bitişini işaretlemek için kullanılır.

İşaretleri ve yorumları (CommentMarkAtProfile, CommentMarkProfile veya MarkProfile) API işlevleri veya işareti komutu ile yerleştirildiğinde işareti profili işlevi içeren iş parçacığı için profil oluşturma durumu açık olmalıdır.

Önemli
MarkProfile yöntemi, yalnızca profil araçları ile birlikte kullanılmalıdır.

.NET Framework Eşdeğeri

Microsoft.VisualStudio.Profiler.dll

Fonksiyon Bilgileri

Başlık: VSPerf.h içinde Bildirilen

Kitaplığı tanımlayın: VSPerf.lib

Örnek

Aşağıdaki kod, MarkProfile işlevini göstermektedir.

void ExerciseMarkProfile()
{
    // Declare and initialize variables to pass to 
    // MarkProfile.  The values of these parameters 
    // are assigned based on the needs of the code;
    // and for the sake of simplicity in this example, 
    // the variables are assigned arbitrary values.
    int markId = 03;

    // Declare enumeration to hold return value of 
    // call to MarkProfile.
    PROFILE_COMMAND_STATUS markResult;

    // Variables used to print output.
    HRESULT hResult;
    TCHAR tchBuffer[256];

    markResult = MarkProfile(markId);

    // Format and print result.
    LPCTSTR pszFormat = TEXT("%s %d.\0");
    TCHAR* pszTxt = TEXT("MarkProfile returned");
    hResult = StringCchPrintf(tchBuffer, 256, pszFormat, 
        pszTxt, markResult);

#ifdef DEBUG
    OutputDebugString(tchBuffer);
#endif
}

Ayrıca bkz.

Diğer Kaynaklar

Visual Studio Profiler API Başvurusu (yerel)

Aracılığıyla paylaş