Udostępnij przez

Obsługa klasy Win32_PerfRawData

Podczas pisania dostawcy o wysokiej wydajności, który dziedziczy klasy z Win32_PerfRawData, należy przestrzegać określonych konwencji, aby WMI mogło dostarczać dane do wartości właściwości.

Notatka

Pisanie dostawcy WMI o wysokiej wydajności w celu tworzenia liczników wydajności nie jest zalecane w żadnej wersji systemu operacyjnego Windows. Aby uzyskać więcej informacji, zobacz Przekształcanie dostawcy instancji w High-Performance dostawcęoraz biblioteki wydajności i WMI.

 

Poniższa procedura opisuje sposób obsługi klasy Win32_PerfRawData u dostawcy o wysokiej wydajności.

Aby obsługiwać klasę Win32_PerfRawData

  1. Utwórz klasę w przestrzeni nazw Root\CIMv2.

    Klasa musi pochodzić z Win32_PerfRawData i mieć kwalifikator Hiperf ustawiony na TRUE. Można również dodać klasy danych wydajności sterownika WDM do przestrzeni nazw root\wmi. Aby uzyskać więcej informacji na temat tworzenia własnej klasy dla usługi WMI, zobacz Projektowanie klas formatu obiektów zarządzanych (MOF).

  2. Określ "NT5_GenericPerfProvider_V1" jako dostawcę w kwalifikatorze dostawcy .

  3. Określ następujące kwalifikatory na poziomie klasy:

    • HiPerf
    • ustawień regionalnych
    • PerfDetail
    • dostawca

    Aby uzyskać więcej informacji, zobacz kwalifikatory dla klas liczników wydajności. Nie definiuj kwalifikatora GenericPerfCtr, ponieważ jest on zarezerwowany dla procesu ADAP, który przesyła dane biblioteki wydajności do klas WMI.

  4. Uzupełnij odpowiednie właściwości związane ze znacznikiem czasu i częstotliwością używane do obliczania formuł typu licznikowego.

    Te właściwości są dziedziczone z Win32_PerfRawData, a jeśli piszesz dostawcę o wysokiej wydajności, należy wypełnić te właściwości, aby klasa została wyświetlona w Monitorze systemu.

  5. Dołącz właściwość klucza o nazwie Name do swojej klasy (ta właściwość nie jest wymagana dla klas singletonowych).

    W klasie nie można używać żadnej właściwości klucza innej niż Nazwa.

  6. Utwórz właściwości typu danych jako DWORD (uint32) lub QWORD (uint64). Te właściwości stają się licznikami wydajności podczas przekazywania do bibliotek wydajnościowych.

  7. Określ następujące kwalifikatory poziomu właściwości dla wszystkich właściwości w klasie:

    • DisplayName
    • CounterType
    • DomyślnaSkala
    • opis
    • PerfDefault
    • PerfDetail

    Aby uzyskać więcej informacji, zobacz kwalifikatory właściwości dla klas liczników wydajności. Ponadto plik nagłówka Winperf.h zawiera wartości, które można określić dla PerfDetail i CounterType.

    WMI używa kwalifikatorów DisplayName, ustawień regionalnychi Opis do lokalizacji. Należy dodać zmodyfikowane kwalifikatory do przestrzeni nazw MS_409 (angielski), aby monitor systemu mógł prawidłowo wyświetlać dane klasy. Oznacza to, że zmieniasz definicję właściwości, dodając kwalifikator Description z tekstem objaśniającym oraz wypełniasz wartość DisplayName. Należy również dodać zmienione kwalifikatory do jakiejkolwiek innej przestrzeni nazw lokalnych obsługiwanej przez twoją klasę. Jeśli użytkownik żąda danych z ustawień regionalnych, dla których nie podano zmienionych kwalifikatorów, usługa WMI określa domyślnie definicje podane w przestrzeni nazw MS_409.

  8. Utwórz właściwość podstawową dla dowolnej właściwości, która ma typ licznika, który oczekuje wartości podstawowej.

    Ta właściwość natychmiast jest zgodna z właściwością i nosi nazwę propertyname**_Base**. Na przykład średnia właściwość AvgDiskBytesPerRead w klasie Win32_PerfRawData_PerfDisk_LogicalDisk wymaga właściwości podstawowej o nazwie AvgDiskBytesPerRead_Base w celu zliczenia liczby próbek. Aby określić, czy typ licznika, którego chcesz użyć, wymaga właściwości bazowej, znajdź ten typ licznika według nazwy lub wartości dziesiętnej w typy liczników wydajności usługi WMI.

  9. Upewnij się, że dostawca spełnia wymagania dotyczące wydajności .

Przekształcanie dostawcy wystąpień w dostawcę High-Performance

 

 

  • Last updated on