イベント ビューアー

カスタム ETW イベントを有効にする

カスタム ETW イベントを使用してコードをインストルメント化し、イベント ビューアーに表示することができます。 カスタム イベントを有効にするには、次のようにします。

1. カスタム イベント コードをビルドします。

   このセクションの最後に、C++ カスタム イベント コードの例が示されています。

2. パフォーマンス プロファイラーを開き (Alt + F2 キー)、イベント ビューアーを有効にして、その横にある [設定] アイコン (歯車アイコン) を選択します。

   

3. ダイアログ ボックスで、[追加のプロバイダー] の最初の行を有効にし、次のいずれかの操作を行います。

   • ネイティブ カスタム イベント コードの場合は、カスタム イベント コードの GUID に基づいて [プロバイダー GUID] を設定し、[プロバイダー名] の値を空のままにするか、既定値を使用します。

   • C# カスタム イベント コードの場合は、イベント コードを宣言するときに使用したのと同じ [プロバイダー名] の値を設定します。 この名前はバックグラウンドで GUID に変換されるため、[プロバイダー GUID] は空のままにします。

     ネイティブ カスタム イベントの場合、行は次の図のようになるはずです。

     

4. [OK] を選択します。

   カスタム イベントは、診断トレースを収集して開くと、イベント ビューアーに表示されます。 次の図は、カスタム イベントのみを表示するようにフィルター処理が設定されたイベント ビューアーのカスタム イベントを示しています。

   

C++ のカスタム イベント コードの例を以下に示します。

#include <Windows.h>
#include <evntprov.h>
#include <iostream>
#include <thread>

// This GUID must be regenerated so it is unique for your provider
// {7369B7AC-64EB-4618-B6B6-C8442B12E8F2}
GUID customEventProvider = { 0x7369b7ac, 0x64eb, 0x4618, { 0xb6, 0xb6, 0xc8, 0x44, 0x2b, 0x12, 0xe8, 0xf2 } };
REGHANDLE _customEventProviderRegHandle = 0;

// Id, Version, Channel, Level, OpCode, Task, Keyword
const EVENT_DESCRIPTOR CustomEventDescriptor = { 1, 0, 0, 0, 0, 0, 1 };

int main()
{
    // Register the provider
    ULONG res = ::EventRegister(&customEventProvider, nullptr, nullptr, &_customEventProviderRegHandle);
    if (res != ERROR_SUCCESS)
    {
        return res;
    }

    byte data[] = { 0xFF, 0xFF, 0xFF, 0xFF };
    EVENT_DATA_DESCRIPTOR eventData[1];
    ::EventDataDescCreate(&(eventData[0]), &data, sizeof(data));

    for (int i = 0; i < 10; ++i)
    {
        std::this_thread::sleep_for(std::chrono::milliseconds(1000));
        ::EventWrite(_customEventProviderRegHandle, &CustomEventDescriptor, _countof(eventData), eventData);
        std::cout << "Wrote event\n";
    }

    res = ::EventUnregister(_customEventProviderRegHandle);
    if (res != ERROR_SUCCESS)
    {
        return res;
    }

    return 0;
}