CommentMarkAtProfile

Makale
02/26/2013

CommentMarkAtProfile yöntemi, .vsp dosyasında zaman damgası değeri, sayısal işaret ve bir de açıklama dizesi ekler.Zaman damgası değeri dış olayları eşitlemek için kullanılır.Eklenecek işaret ve yorum için, CommentMarkAtProfile işlevini içeren iş parçacığı için ayrımlamanın açık olması gerekir.

PROFILE_COMMAND_STATUS PROFILERAPI CommentMarkAtProfile (
                                   __int64 dnTimestamp,
                                   long lMarker,
                                   LPCTSTR szComment);

Parametreler

dnTimestamp

Zaman damgası değerini temsil eden bir 64-bit tamsayısı.

lMarker

Eklenecek sayısal işaretleyici.Işaretleyici sıfıra eşit veya sıfırdan büyük olmalıdır.

szComment

Metin dizesine eklemek için bir işaretçi.Dize NULL sonlandırıcı dahil 256 karakterden az 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

İş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.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.

Önemli
CommentMarkAtProfile yöntemleri, yalnızca enstrümentasyon ile birlikte kullanılmalıdır.

.NET Framework Eşdeğeri

Microsoft.VisualStudio.Profiler.dll

Fonksiyon Bilgileri

Üstbilgi	VSPerf.h Ekle
Kitaplık	VSPerf.lib Kullan
Unicode	CommentMarkAtProfileW (Unicode) ve CommentMarkAtProfileA (ANSI) olarak uygulanır.

Örnek

Aşağıdaki kod CommentMarkAtProfile genel işlev çağrısı kullanımını göstermektedir.Örnek Win32 dize makrolarının kullanımını ve kodun ANSI etkin fonksiyonu çağırıp çağırmadığını belirlemek için ANSI derleyici ayarlarını varsayar.

void ExerciseCommentMarkAtProfile(void)
{
    // Declare and initalize variables to pass to 
    // CommentMarkAtProfile.  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.
    int64 timeStamp = 0x1111;
    long markId = 01;
    TCHAR * markText = TEXT("Exercising CommentMarkAtProfile...");

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

    // Declare MarkOperationResult Enumerator.  
    // Holds return value from call to CommentMarkAtProfile.
    PROFILE_COMMAND_STATUS markResult;

    markResult = CommentMarkAtProfile(
        timeStamp,
        markId,
        markText);

    // Format and print result.
    LPCTSTR pszFormat = TEXT("%s %d.\0");
    TCHAR* pszTxt = TEXT("CommentMarkAtProfile 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ş