Share via


CvCreateMarkerSeriesWithCodePageA Function

Creates marker series for a given provider and specifed code page. This function can be used to specify the code page explicitly for the text written out by marker API ANSI functions. Setting the code page can be useful in case the trace is captured and then analyzed on different machines with different locales/languages. By default the code page returned by GetACP() function is used.

HRESULT CvCreateMarkerSeriesWithCodePageA(
   _In_ PCV_PROVIDER pProvider,
   _In_ LPCSTR pSeriesName,
   _In_ UINT nTextCodePage,
   _Out_ PCV_MARKERSERIES* ppMarkerSeries
);

Parameters

  • pProvider
    Provider object previously initialized by CvInitProvider. Cannot be NULL.

  • pSeriesName
    Marker series name. Cannot be NULL but empty string is allowed.

  • nTextCodePage
    Valid code page.

  • ppMarkerSeries
    Address of an output variable which will store marker series context. Cannot be NULL.

Return Value

S_OK when marker series is successfully created or error code in case there were any errors. Use SUCCEEDED/FAILED macros to check for error condition.

Requirements

Header: cvmarkers.h

See Also

Concepts

C++ Library Reference