次の方法で共有


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

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

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

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

  1. 更新可能なオブジェクトと 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;
    
  2. 次のアクションを実行するループを作成します。

次の 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