C++ でのパフォーマンスデータへのアクセス

[アーティクル]
07/03/2023

WMI ハイパフォーマンス API は、パフォーマンスカウンタークラスからデータを取得する一連のインターフェイスです。これらのインターフェイスでは、サンプリングレートを上げるために "リフレッシャー" オブジェクトを使用する必要があります。スクリプティングでリフレッシャーオブジェクトを使用する方法の詳細については、「スクリプトでのパフォーマンスデータへのアクセス」および「WMI タスク: パフォーマンスの監視」を参照してください。

このトピックでは、以下のセクションについて説明します。

パフォーマンスデータの更新
WMI リフレッシャーへの列挙子の追加
例
関連トピック

パフォーマンスデータの更新

リフレッシャーオブジェクトは、プロセス境界を越えずにデータを取得することで、データプロバイダーとクライアントのパフォーマンスを向上させます。クライアントとサーバーの両方が同じコンピューター上にある場合、リフレッシャーは、処理中のハイパフォーマンスプロバイダーをクライアントに読み込み、プロバイダーオブジェクトからクライアントオブジェクトに直接データをコピーします。クライアントとサーバーが異なるコンピューターに配置されている場合は、リモートコンピューター上のオブジェクトをキャッシュし、最小限のデータセットをクライアントに送信することで、リフレッシャーのパフォーマンスを向上させます。

リフレッシャーは、次のことも行います。

ネットワークエラーが発生したとき、またはリモートコンピューターが再起動されたときに、クライアントをリモート WMI サービスに自動的に再接続します。

既定では、2 台のコンピューター間のリモート接続が失敗すると、リフレッシャーによって関連するハイパフォーマンスプロバイダーへのアプリケーションの再接続が試みられます。再接続を防ぐには、Refresh メソッドの呼び出しでWBEM_FLAG_REFRESH_NO_AUTO_RECONNECT フラグを渡します。スクリプトクライアントでは、SWbemRefresher.AutoReconnect プロパティを FALSE に設定する必要があります。
同じプロバイダーまたは異なるプロバイダーによって提供される複数のオブジェクトと列挙子を読み込みます。

複数のオブジェクト、列挙子、またはその両方をリフレッシャーに追加できます。
オブジェクトを列挙します。

他のプロバイダーと同様に、ハイパフォーマンスプロバイダーはオブジェクトを列挙できます。

ハイパフォーマンスクライアントの作成を完了した後に、応答時間を改善したいと思うことがあるかもしれません。 IWbemObjectAccess インターフェイスは速度に対して最適化されているため、インターフェイスが本質的にスレッドセーフではありません。したがって、更新操作中は、更新可能なオブジェクトや列挙にアクセスしないでください。 IWbemObjectAccess メソッドの呼び出し中にスレッド間でオブジェクトを保護するには、IWbemObjectAccess::Lock メソッドと Unlock メソッドを使用します。パフォーマンスを向上させるには、スレッドを同期して、個々のスレッドをロックする必要をなくしてください。スレッドを減らし、更新操作用にオブジェクトのグループを同期することで、全体的なパフォーマンスを最適化できます。

WMI リフレッシャーへの列挙子の追加

インスタンスの数と各インスタンスのデータは、リフレッシャーに列挙子を追加することで更新されます。これにより、IWbemRefresher::Refresh の呼び出しごとに完全な列挙が行われるようになります。

以下の C++ コード例を正しくコンパイルするには、次の参照と #include ステートメントが必要です。

#define _WIN32_DCOM

#include <iostream>
using namespace std;
#include <Wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")

次の手順では、リフレッシャーに列挙子を追加する方法を示します。

リフレッシャーに列挙子を追加するには

更新可能なオブジェクトと IWbemServices インターフェイスへのパスを使用して、IWbemConfigureRefresher::AddEnum メソッドを呼び出します。

リフレッシャーは、IWbemHiPerfEnum インターフェイスへのポインターを返します。 IWbemHiPerfEnum インターフェイスを使用すると、列挙内のオブジェクトにアクセスできます。
```
IWbemHiPerfEnum* pEnum = NULL;
long lID;
IWbemConfigureRefresher* pConfig;
IWbemServices* pNameSpace;

// Add an enumerator to the refresher.
if (FAILED (hr = pConfig->AddEnum(
    pNameSpace, 
    L"Win32_PerfRawData_PerfProc_Process", 
    0, 
    NULL,
    &pEnum, 
    &lID)))
{
    goto CLEANUP;
}
pConfig->Release();
pConfig = NULL;
```
次のアクションを実行するループを作成します。
- IWbemRefresher::Refresh の呼び出しを使用してオブジェクトを更新する。
- IWbemHiPerfEnum::GetObjects メソッドに IWbemObjectAccess インターフェイスポインターの配列を提供する。
- GetObjects に渡される IWbemObjectAccess メソッドを使用して、列挙子のプロパティにアクセスする。
  
  プロパティハンドルを各 IWbemObjectAccess インスタンスに渡すことで、更新された値を取得できます。クライアントは Release を呼び出して、GetObjects によって返された IWbemObjectAccess ポインターを解放する必要があります。

例

次の C++ コード例では、ハイパフォーマンスクラスを列挙しています。クライアントは最初のオブジェクトからプロパティハンドルを取得し、更新操作の残りの部分のためにハンドルを再利用します。 Refresh メソッドを呼び出すと、そのたびにインスタンスの数とインスタンスデータが更新されます。

#define _WIN32_DCOM

#include <iostream>
using namespace std;
#include <Wbemidl.h>

#pragma comment(lib, "wbemuuid.lib")

int __cdecl wmain(int argc, wchar_t* argv[])
{
    // To add error checking,
    // check returned HRESULT below where collected.
    HRESULT                 hr = S_OK;
    IWbemRefresher          *pRefresher = NULL;
    IWbemConfigureRefresher *pConfig = NULL;
    IWbemHiPerfEnum         *pEnum = NULL;
    IWbemServices           *pNameSpace = NULL;
    IWbemLocator            *pWbemLocator = NULL;
    IWbemObjectAccess       **apEnumAccess = NULL;
    BSTR                    bstrNameSpace = NULL;
    long                    lID = 0;
    long                    lVirtualBytesHandle = 0;
    long                    lIDProcessHandle = 0;
    DWORD                   dwVirtualBytes = 0;
    DWORD                   dwProcessId = 0;
    DWORD                   dwNumObjects = 0;
    DWORD                   dwNumReturned = 0;
    DWORD                   dwIDProcess = 0;
    DWORD                   i=0;
    int                     x=0;

    if (FAILED (hr = CoInitializeEx(NULL,COINIT_MULTITHREADED)))
    {
        goto CLEANUP;
    }

    if (FAILED (hr = CoInitializeSecurity(
        NULL,
        -1,
        NULL,
        NULL,
        RPC_C_AUTHN_LEVEL_NONE,
        RPC_C_IMP_LEVEL_IMPERSONATE,
        NULL, EOAC_NONE, 0)))
    {
        goto CLEANUP;
    }

    if (FAILED (hr = CoCreateInstance(
        CLSID_WbemLocator, 
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IWbemLocator,
        (void**) &pWbemLocator)))
    {
        goto CLEANUP;
    }

    // Connect to the desired namespace.
    bstrNameSpace = SysAllocString(L"\\\\.\\root\\cimv2");
    if (NULL == bstrNameSpace)
    {
        hr = E_OUTOFMEMORY;
        goto CLEANUP;
    }
    if (FAILED (hr = pWbemLocator->ConnectServer(
        bstrNameSpace,
        NULL, // User name
        NULL, // Password
        NULL, // Locale
        0L,   // Security flags
        NULL, // Authority
        NULL, // Wbem context
        &pNameSpace)))
    {
        goto CLEANUP;
    }
    pWbemLocator->Release();
    pWbemLocator=NULL;
    SysFreeString(bstrNameSpace);
    bstrNameSpace = NULL;

    if (FAILED (hr = CoCreateInstance(
        CLSID_WbemRefresher,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IWbemRefresher, 
        (void**) &pRefresher)))
    {
        goto CLEANUP;
    }

    if (FAILED (hr = pRefresher->QueryInterface(
        IID_IWbemConfigureRefresher,
        (void **)&pConfig)))
    {
        goto CLEANUP;
    }

    // Add an enumerator to the refresher.
    if (FAILED (hr = pConfig->AddEnum(
        pNameSpace, 
        L"Win32_PerfRawData_PerfProc_Process", 
        0, 
        NULL, 
        &pEnum, 
        &lID)))
    {
        goto CLEANUP;
    }
    pConfig->Release();
    pConfig = NULL;

    // Get a property handle for the VirtualBytes property.

    // Refresh the object ten times and retrieve the value.
    for(x = 0; x < 10; x++)
    {
        dwNumReturned = 0;
        dwIDProcess = 0;
        dwNumObjects = 0;

        if (FAILED (hr =pRefresher->Refresh(0L)))
        {
            goto CLEANUP;
        }

        hr = pEnum->GetObjects(0L, 
            dwNumObjects, 
            apEnumAccess, 
            &dwNumReturned);
        // If the buffer was not big enough,
        // allocate a bigger buffer and retry.
        if (hr == WBEM_E_BUFFER_TOO_SMALL 
            && dwNumReturned > dwNumObjects)
        {
            apEnumAccess = new IWbemObjectAccess*[dwNumReturned];
            if (NULL == apEnumAccess)
            {
                hr = E_OUTOFMEMORY;
                goto CLEANUP;
            }
            SecureZeroMemory(apEnumAccess,
                dwNumReturned*sizeof(IWbemObjectAccess*));
            dwNumObjects = dwNumReturned;

            if (FAILED (hr = pEnum->GetObjects(0L, 
                dwNumObjects, 
                apEnumAccess, 
                &dwNumReturned)))
            {
                goto CLEANUP;
            }
        }
        else
        {
            if (hr == WBEM_S_NO_ERROR)
            {
                hr = WBEM_E_NOT_FOUND;
                goto CLEANUP;
            }
        }

        // First time through, get the handles.
        if (0 == x)
        {
            CIMTYPE VirtualBytesType;
            CIMTYPE ProcessHandleType;
            if (FAILED (hr = apEnumAccess[0]->GetPropertyHandle(
                L"VirtualBytes",
                &VirtualBytesType,
                &lVirtualBytesHandle)))
            {
                goto CLEANUP;
            }
            if (FAILED (hr = apEnumAccess[0]->GetPropertyHandle(
                L"IDProcess",
                &ProcessHandleType,
                &lIDProcessHandle)))
            {
                goto CLEANUP;
            }
        }
           
        for (i = 0; i < dwNumReturned; i++)
        {
            if (FAILED (hr = apEnumAccess[i]->ReadDWORD(
                lVirtualBytesHandle,
                &dwVirtualBytes)))
            {
                goto CLEANUP;
            }
            if (FAILED (hr = apEnumAccess[i]->ReadDWORD(
                lIDProcessHandle,
                &dwIDProcess)))
            {
                goto CLEANUP;
            }

            wprintf(L"Process ID %lu is using %lu bytes\n",
                dwIDProcess, dwVirtualBytes);

            // Done with the object
            apEnumAccess[i]->Release();
            apEnumAccess[i] = NULL;
        }

        if (NULL != apEnumAccess)
        {
            delete [] apEnumAccess;
            apEnumAccess = NULL;
        }

       // Sleep for a second.
       Sleep(1000);
    }
    // exit loop here
    CLEANUP:

    if (NULL != bstrNameSpace)
    {
        SysFreeString(bstrNameSpace);
    }

    if (NULL != apEnumAccess)
    {
        for (i = 0; i < dwNumReturned; i++)
        {
            if (apEnumAccess[i] != NULL)
            {
                apEnumAccess[i]->Release();
                apEnumAccess[i] = NULL;
            }
        }
        delete [] apEnumAccess;
    }
    if (NULL != pWbemLocator)
    {
        pWbemLocator->Release();
    }
    if (NULL != pNameSpace)
    {
        pNameSpace->Release();
    }
    if (NULL != pEnum)
    {
        pEnum->Release();
    }
    if (NULL != pConfig)
    {
        pConfig->Release();
    }
    if (NULL != pRefresher)
    {
        pRefresher->Release();
    }

    CoUninitialize();

    if (FAILED (hr))
    {
        wprintf (L"Error status=%08x\n",hr);
    }

    return 1;
}

パフォーマンスカウンタークラス
スクリプトでのパフォーマンスデータへのアクセス
スクリプトでの WMI データのリフレッシュ
WMI タスク: パフォーマンスの監視
パフォーマンスデータの監視
書式設定されたパフォーマンスカウンタークラスのプロパティ修飾子
WMI パフォーマンスカウンター型
Wmiadap.exe
QueryPerformanceCounter

次の方法で共有

C++ でのパフォーマンスデータへのアクセス

パフォーマンスデータの更新

WMI リフレッシャーへの列挙子の追加

例

フィードバック

その他のリソース

次の方法で共有

C++ でのパフォーマンス データへのアクセス

パフォーマンス データの更新

WMI リフレッシャーへの列挙子の追加

例

関連トピック

フィードバック

その他のリソース

C++ でのパフォーマンスデータへのアクセス

パフォーマンスデータの更新