CommentMarkProfile

Funkcja CommentMarkProfile wstawia znacznik liczbowy i ciąg tekstowy, w pliku vsp.Aby znacznik i komentarz zostały dodane, musi być włączone profilowanie dla wątku który zawiera funkcję CommentMarkProfile.

PROFILE_COMMAND_STATUS PROFILERAPI CommentMarkProfile(
                                   long lMarker, 
                                   LPCTSTR szComment);

Parametry

lMarker

Znacznik numeryczny do wstawienia.Znacznik musi być większy lub równy 0 (zero).

szComment

Wskaźnik do ciągu tekstowego do wstawienia.Ciąg musi być mniejszy niż 256 znaków, włączając terminator NULL.

Wartość właściwości/Zwracana wartość

Funkcja wskazuje powodzenie lub niepowodzenie za pomocą wyliczenia PROFILE_COMMAND_STATUS.Zwracana wartość może być jedną z następujących:

Moduł wyliczający	Opis
MARK_ERROR_MARKER_RESERVED	Parametr jest mniejszy lub równy 0.Wartości te są zastrzeżone.Znacznik i komentarz nie są rejestrowane.
MARK_ERROR_MODE_NEVER	Tryb profilowania został ustawiony na NEVER, gdy funkcja została wywołana.Znacznik i komentarz nie są rejestrowane.
MARK_ERROR_MODE_OFF	Tryb profilowania został ustawiony na OFF, gdy funkcja została wywołana.Znacznik i komentarz nie są rejestrowane.
MARK_ERROR_NO_SUPPORT	Brak obsługi znacznika w tym kontekście.Znacznik i komentarz nie są rejestrowane.
MARK_ERROR_OUTOFMEMORY	Brak dostępnej pamięci, aby zarejestrować zdarzenie.Znacznik i komentarz nie są rejestrowane.
MARK_TEXTTOOLONG	Ciąg przekracza maksymalną długość 256 znaków.Ciąg komentarza został obcięty, a znacznik i komentarz są rejestrowane.
MARK_OK	Zwracana wartość MARK_OK oznacza powodzenie.

Uwagi

Stan profilowania wątku, który zawiera funkcję profilowania znacznika, musi być włączony, gdy znaczniki i komentarze są wstawiane za pomocą polecenia VSInstr Mark lub funkcji (CommentMarkAtProfile, CommentMarkProfile lub MarkProfile).

Znaczniki profilowania mają zakres globalny.Na przykład, znacznik profilowania wstawiony w jednym wątku może zostać użyty do oznaczenia początku lub końca segmentu danych, w dowolnym wątku w pliku .vsp.

Ważne
Metody CommentMarkProfile można użyć wyłącznie z instrumentacją.

Odpowiednik w programie .NET Framework

Microsoft.VisualStudio.Profiler.dll

Informacje o funkcji

Nagłówek	Zawiera VSPerf.h
Biblioteka	Użyj VSPerf.lib
Unicode	Zaimplementowane jako CommentMarkProfileW (Unicode) i CommentMarkProfileA (ANSI).

Przykład

Poniższy kod ilustruje wywołanie funkcji CommentMarkProfile.W przykładzie założono użycie makr ciągów Win32 i ustawień kompilatora Unicode aby ustalić, czy kod wywołuje wywołanie funkcji ANSI.

void ExerciseCommentMarkProfile()
{
    // Declare and initalize variables to pass to 
    // CommentMarkProfile.  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.
    long markId = 01;
    TCHAR * markText = TEXT("Exercising CommentMarkProfile...");

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

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

    markResult = CommentMarkProfile(
        markId,
        markText);

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

#ifdef DEBUG
    OutputDebugString(tchBuffer);
#endif
}

Zobacz też

Inne zasoby

Interfejsy API profilera Visual Studio (Native)