WMI のプレインストール済みパフォーマンスクラスへのアクセス

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

WMI リポジトリには、すべてのパフォーマンスライブラリオブジェクトに対応した、プレインストール済みのパフォーマンスクラスが含まれています。たとえば、生データパフォーマンスクラス Win32_PerfRawData_PerfProc_Process のインスタンスは、プロセスを表します。このパフォーマンスオブジェクトは、システムモニターで Process オブジェクトとして表示されます。

Win32_PerfRawData_PerfProc_Process の PageFaultsPerSec プロパティは、プロセスの 1 秒あたりの Page Faults パフォーマンスカウンターを表します。 Win32_PerfFormattedData クラスには、システムモニター (Perfmon.exe) に表示される計算済みのデータ値が含まれます。 Win32_PerfFormattedData_PerfProc_Process の PageFaultsPerSec プロパティの値は、システムモニターに表示される場合のものと同じです。

パフォーマンスカウンタークラスを使用してパフォーマンスデータにアクセスするには、WMI 用 COM API または WMI 用スクリプト API を使用します。どちらの場合も、各データサンプルを取得するには "リフレッシャー" オブジェクトが必要です。リフレッシャーの使用とパフォーマンスクラスへのアクセスに関する詳細とスクリプトコード例については、「WMI タスク: パフォーマンス監視」を参照してください。詳細については、「スクリプトでのパフォーマンスデータへのアクセス」を参照してください。

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

次の C++ コード例では、パフォーマンスカウンタープロバイダーを使用して、定義済みのハイパフォーマンスクラスにアクセスしています。リフレッシャーオブジェクトを作成し、オブジェクトをリフレッシャーに追加しています。このオブジェクトは、特定のプロセスのパフォーマンスを監視する Win32_PerfRawData_PerfProc_Process インスタンスです。コードは、プロセスオブジェクトのカウンタープロパティを 1 つだけ読み取ります (VirtualBytes プロパティ)。コードでは、正しくコンパイルするために次の参照と #include ステートメントが必要となります。

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

次の手順は、C++ でハイパフォーマンスプロバイダーからデータにアクセスする方法を示したものです。

C++ でハイパフォーマンスプロバイダーからデータにアクセスするには

WMI 名前空間への接続を確立し、IWbemLocator::ConnectServer と CoSetProxyBlanket への呼び出しを使用して WMI セキュリティを設定します。

この手順は、WMI クライアントアプリケーションを作成するための標準的な手順です。詳細については、「C++ を使用した WMI アプリケーションの作成」を参照してください。
CoCreateInstance と CLSID_WbemRefresher を使用して、リフレッシャーオブジェクトを作成します。 QueryInterface メソッドを使用して IWbemConfigureRefresher インターフェイスを要求します。 QueryInterface メソッドを使用して IWbemRefresher インターフェイスを要求します。

IWbemRefresher インターフェイスは、WMI Refresher オブジェクトのメインインターフェイスです。

次の C++ コード例は、IWbemConfigureRefresher の取得方法を示したものです。
```
IWbemRefresher* pRefresher = NULL;

HRESULT hr = CoCreateInstance(
    CLSID_WbemRefresher,
    NULL,
    CLSCTX_INPROC_SERVER,
    IID_IWbemRefresher,
    (void**) &pRefresher);

IWbemConfigureRefresher* pConfig = NULL;

pRefresher->QueryInterface( 
    IID_IWbemConfigureRefresher,
    (void**) &pConfig
  );
```
IWbemConfigureRefresher::AddObjectByPath メソッドを呼び出して、リフレッシャーにオブジェクトを追加します。

リフレッシャーにオブジェクトを追加すると、IWbemRefresher::Refresh メソッドを呼び出すたびに、そのオブジェクトが WMI によって更新されます。追加するオブジェクトでは、クラス修飾子でプロバイダーを指定します。

次の C++ コード例は、AddObjectByPath を呼び出す方法を示したものです。
```
IWbemClassObject* pObj = NULL;
IWbemServices* pNameSpace = NULL;

// Add the instance to be refreshed.
hr = pConfig->AddObjectByPath(
     pNameSpace,
     L"Win32_PerfRawData_PerfProc_Process.Name=\"WINWORD\"",
     0L,
     NULL,
     &pObj,
     NULL
);
if (FAILED(hr))
{
   cout << "Could not add object. Error code: 0x"
        << hex << hr << endl;
   pNameSpace->Release();
   return hr;
}
```
オブジェクトへのアクセスを高速化するには、IWbemClassObject インターフェイスの QueryInterface を使用して IWbemObjectAccess インターフェイスに接続します。

次の C++ コード例は、IWbemClassObject ではなく IWbemObjectAccess を使用してオブジェクトへのポインターを取得する方法を示したものです。
```
    // For quick property retrieval, use IWbemObjectAccess.
    IWbemObjectAccess* pAcc = NULL;
    pObj->QueryInterface( IID_IWbemObjectAccess, (void**) &pAcc );
    // This is not required.
    pObj->Release();
```
IWbemObjectAccess インターフェイスを使用すると、特定のカウンタープロパティへのハンドルを取得できるため、パフォーマンスが向上します。これには、コード内のオブジェクトをロックおよびロック解除する必要があります。これは、IWbemClassObject がプロパティアクセスごとに実行する操作です。
IWbemObjectAccess::GetPropertyHandle メソッドへの呼び出しを使用して、調べるプロパティのハンドルを取得します。

プロパティハンドルは、クラスのすべてのインスタンスで同じです。つまり、特定のクラスのすべてのインスタンスに対して、特定のインスタンスから取得したプロパティハンドルを使用できます。クラスオブジェクトからハンドルを取得して、インスタンスオブジェクトからプロパティ値を取得することもできます。

次の C++ コード例は、プロパティハンドルの取得方法を示したものです。
```
    // Get a property handle for the VirtualBytes property
    long lVirtualBytesHandle = 0;
    DWORD dwVirtualBytes = 0;
    CIMTYPE variant;

    hr = pAcc->GetPropertyHandle(L"VirtualBytes",
         &variant,
         &lVirtualBytesHandle 
    );
    if (FAILED(hr))
    {
       cout << "Could not get property handle. Error code: 0x"
            << hex << hr << endl;
       return hr;
    }
```
次のアクションを実行するプログラミングループを作成します。
- CoCreateInstance に対する前回の呼び出しで作成されたポインターを使用して、IWbemRefresher::Refresh の呼び出しによってオブジェクトを更新する。
  
  この呼び出しでは、WMI Refresher が、プロバイダーの提供するデータを使用してクライアントオブジェクトを更新します。
- 必要に応じて、オブジェクトに対する任意のアクションを実行する (プロパティ名、データ型、値の取得など)。
  
  プロパティには、先ほど取得したプロパティハンドルを使用してアクセスできます。 Refresh の呼び出しがあるので、WMI はループを通じて毎回プロパティを更新します。

次の C++ の例は、WMI ハイパフォーマンス API の使用方法を示したものです。

// Get the local locator object
IWbemServices* pNameSpace = NULL;
IWbemLocator* pWbemLocator = NULL;
CIMTYPE variant;
VARIANT VT;

CoCreateInstance( CLSID_WbemLocator, NULL,
    CLSCTX_INPROC_SERVER, IID_IWbemLocator, (void**) &pWbemLocator
);

// Connect to the desired namespace
BSTR bstrNameSpace = SysAllocString( L"\\\\.\\root\\cimv2" );

HRESULT hr = WBEM_S_NO_ERROR;

hr = pWbemLocator->ConnectServer(
     bstrNameSpace,      // Namespace name
     NULL,               // User name
     NULL,               // Password
     NULL,               // Locale
     0L,                 // Security flags
     NULL,               // Authority
     NULL,               // Wbem context
     &pNameSpace         // Namespace
);

if ( SUCCEEDED( hr ) )
{
    // Set namespace security.
    IUnknown* pUnk = NULL;
    pNameSpace->QueryInterface( IID_IUnknown, (void**) &pUnk );

    hr = CoSetProxyBlanket(
         pNameSpace, 
         RPC_C_AUTHN_WINNT, 
         RPC_C_AUTHZ_NONE, 
         NULL, 
         RPC_C_AUTHN_LEVEL_DEFAULT, 
         RPC_C_IMP_LEVEL_IMPERSONATE,
         NULL, 
         EOAC_NONE 
    );
    if (FAILED(hr))
    {
       cout << "Cannot set proxy blanket. Error code: 0x"
            << hex << hr << endl;
       pNameSpace->Release();
       return hr;
    }

    hr = CoSetProxyBlanket(pUnk, 
         RPC_C_AUTHN_WINNT, 
         RPC_C_AUTHZ_NONE, 
         NULL, 
         RPC_C_AUTHN_LEVEL_DEFAULT, 
         RPC_C_IMP_LEVEL_IMPERSONATE,
         NULL, 
         EOAC_NONE 
    );
    if (FAILED(hr))
    {
       cout << "Cannot set proxy blanket. Error code: 0x"
            << hex << hr << endl;
       pUnk->Release();
       return hr;
    }

    // Clean up the IUnknown.
    pUnk->Release();

    IWbemRefresher* pRefresher = NULL;
    IWbemConfigureRefresher* pConfig = NULL;

    // Create a WMI Refresher and get a pointer to the
    // IWbemConfigureRefresher interface.
    CoCreateInstance(CLSID_WbemRefresher, 
                     NULL,
                     CLSCTX_INPROC_SERVER, 
                     IID_IWbemRefresher, 
                     (void**) &pRefresher 
    );
    
    pRefresher->QueryInterface(IID_IWbemConfigureRefresher,
                               (void**) &pConfig );

    IWbemClassObject* pObj = NULL;

    // Add the instance to be refreshed.
    pConfig->AddObjectByPath(
       pNameSpace,
       L"Win32_PerfRawData_PerfProc_Process.Name=\"WINWORD\"",
       0L,
       NULL,
       &pObj,
       NULL 
    );
    if (FAILED(hr))
    {
       cout << "Cannot add object. Error code: 0x"
            << hex << hr << endl;
       pNameSpace->Release();
       
       return hr;
    }

    // For quick property retrieval, use IWbemObjectAccess.
    IWbemObjectAccess* pAcc = NULL;
    pObj->QueryInterface(IID_IWbemObjectAccess, 
                         (void**) &pAcc );

    // This is not required.
    pObj->Release();

    // Get a property handle for the VirtualBytes property.
    long lVirtualBytesHandle = 0;
    DWORD dwVirtualBytes = 0;

    pAcc->GetPropertyHandle(L"VirtualBytes", 
                            &variant, 
                            &lVirtualBytesHandle );

    // Refresh the object ten times and retrieve the value.
    for( int x = 0; x < 10; x++ )
    {
        pRefresher->Refresh( 0L );
        pAcc->ReadDWORD( lVirtualBytesHandle, &dwVirtualBytes );
        printf( "Process is using %lu bytes\n", dwVirtualBytes );
        // Sleep for a second.
        Sleep( 1000 );
    }
    // Clean up all the objects.
    pAcc->Release();
    // Done with these too.
    pConfig->Release();
    pRefresher->Release();
    pNameSpace->Release();
}
SysFreeString( bstrNameSpace );
pWbemLocator->Release();

パフォーマンスカウンタークラス
WMI タスク: パフォーマンスの監視

次の方法で共有

WMI のプレインストール済みパフォーマンスクラスへのアクセス

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

フィードバック

その他のリソース

次の方法で共有

WMI のプレインストール済みパフォーマンス クラスへのアクセス

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

関連トピック

フィードバック

その他のリソース

WMI のプレインストール済みパフォーマンスクラスへのアクセス

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