MarkProfile
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
The MarkProfile method inserts a profile mark in the .vsp file. Profiling for the thread containing the MarkProfile function must be ON for the mark to be inserted.
Syntax
PROFILE_COMMAND_STATUS PROFILERAPI MarkProfile( long lMarker );
Parameters
lMarker
The marker to insert. The marker must be greater than or equal to 0 (zero).
Property Value/Return Value
The function indicates success or failure by using PROFILE_COMMAND_STATUS enumeration. The return value can be one of the following:
| Enumerator | Description |
|---|---|
| MARK_ERROR_MARKER_RESERVED | The parameter is less than or equal to 0. These values are reserved. The mark and comment are not recorded. |
| MARK_ERROR_MODE_NEVER | The profiling mode was set to NEVER when the function was called. The mark and comment are not recorded. |
| MARK_ERROR_MODE_OFF | The profiling mode was set to OFF when the function was called. The mark and comment are not recorded. |
| MARK_ERROR_NO_SUPPORT | No mark support in this context. The mark and comment are not recorded. |
| MARK_ERROR_OUTOFMEMORY | Memory was not available to record the event. The mark and comment are not recorded. |
| MARK_TEXTTOOLONG | The string exceeds the maximum of 256 characters. The comment string is truncated and the mark and comment are recorded. |
| MARK_OK | MARK_OK is returned to indicate success. |
Remarks
The mark value is inserted into the .vsp file each time the code runs if the thread containing the MarkProfile function is being profiled. You can call MarkProfile multiple times.
Profile marks are global in scope. For example, a profile mark inserted in one thread can be used to mark the start or end of a data segment in any thread in the .vsp file.
The profiling state for the thread that contains the mark profile function must be on when marks and comments inserted with the Mark command or with API functions (CommentMarkAtProfile, CommentMarkProfile, or MarkProfile).
Important
MarkProfile method should be used with instrumentation profiling only.
.NET Framework Equivalent
Microsoft.VisualStudio.Profiler.dll
Function Information
Header: Declared in VSPerf.h
Import library: VSPerf.lib
Example
The following code illustrates the MarkProfile function.
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
}