CvWriteMessage 関数CvWriteMessage function

同時実行ビジュアライザーのトレース ファイルにメッセージを書き込みます。Writes a message to the Concurrency Visualizer trace file.

構文Syntax

HRESULT CvWriteMessageW(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ PCWSTR pMessage,  
    ...  
    );  

HRESULT CvWriteMessageA(  
    PCV_MARKERSERIES pMarkerSeries,  
    _In_ PCSTR pMessage,  
    ...  
    );  

HRESULT CvWriteMessageVW(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ PCWSTR pMessage,  
    _In_ va_list argList);  

HRESULT CvWriteMessageVA(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ PCSTR pMessage,  
    _In_ va_list argList);  

HRESULT CvWriteMessageExW(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ CV_IMPORTANCE level,  
    _In_ int category,  
    _In_ PCWSTR pMessage,  
    ...  
    );  

HRESULT CvWriteMessageExA(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ CV_IMPORTANCE level,  
    _In_ int category,  
    _In_ PCSTR pMessage,  
    ...  
    );  

HRESULT CvWriteMessageExVW(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ CV_IMPORTANCE level,  
    _In_ int category,  
    _In_ PCWSTR pMessage,  
    _In_ va_list argList);  

HRESULT CvWriteMessageExVA(  
    _In_reads_bytes_(16) PCV_MARKERSERIES pMarkerSeries,  
    _In_ CV_IMPORTANCE level,  
    _In_ int category,  
    _In_ PCSTR pMessage,  
    _In_ va_list argList);  

パラメーターParameters

argList
引数リスト。List of arguments.

category
スパンのカテゴリCategory of the span

level
スパンの重要度レベル。Importance level of the span.

pMarkerSeries
有効なマーカー シリーズ コンテキスト。Valid marker series context. Nll は指定できません。Cannot be NULL.

pMessage
メッセージの書式設定文字列。Message format string. Nll は指定できません。Cannot be NULL.

戻り値Return value

メッセージが書き込まれると S_OK を返します。S_OK when the message is successfully written. エラーが発生した場合はエラー コードを返します。Error code in case there were any errors. SUCCEEDED/FAILED マクロを使用し、エラーの状態を確認します。Use SUCCEEDED/FAILED macros to check for error condition.

必要条件Requirements

ヘッダー: cvmarkers.hHeader: cvmarkers.h

Unicode: CvWriteMessageW、CvWriteMessageVW、CvWriteMessageExW、CvWriteMessageExVWUnicode: CvWriteMessageW, CvWriteMessageVW, CvWriteMessageExW, CvWriteMessageExVW

ANSI: CvWriteMessageA、CvWriteMessageVA、CvWriteMessageExA、CvWriteMessageExVAANSI: CvWriteMessageA, CvWriteMessageVA, CvWriteMessageExA, CvWriteMessageExVA

関連項目See also

C++ ライブラリ リファレンスC++ library reference