Unterstützen der Klasse „Win32_PerfRawData“
Beim Schreiben eines Hochleistungsanbieters, der Klassen von Win32_PerfRawData ableitet, müssen Sie bestimmte Konventionen einhalten, damit WMI Daten für die Eigenschaftswerte bereitstellen kann.
Hinweis
Das Schreiben eines WMI-Hochleistungsanbieters zum Erstellen von Leistungsindikatoren wird für keine Version des Windows-Betriebssystems empfohlen. Weitere Informationen finden Sie unter Umwandeln eines Instanzanbieters in einen Hochleistungsanbieter und Leistungsbibliotheken und WMI.
Im folgenden Verfahren wird beschrieben, wie Sie die Klasse Win32_PerfRawData mit Ihrem Hochleistungsanbieter unterstützen.
So unterstützen Sie die Klasse „Win32_PerfRawData“
Erstellen Sie Ihre Klasse im Namespace „Root\CIMv2“.
Die Klasse muss von Win32_PerfRawData abgeleitet werden, und der Qualifizierer Hiperf muss auf TRUE festgelegt sein. Sie können dem Namespace „root\wmi“ auch WDM (Treiber)-Leistungsdatenklassen hinzufügen. Weitere Informationen zum Erstellen Ihrer eigenen Klasse für WMI finden Sie unter Entwerfen von MOF-Klassen (Managed Object Format).
Geben Sie den Anbieter im Qualifizierer Anbieter als „NT5_GenericPerfProvider_V1“ an.
Geben Sie die folgenden Qualifizierer auf Klassenebene an:
- HiPerf
- Gebietsschema
- PerfDetail
- Anbieter
Weitere Informationen finden Sie unter Klassenqualifizierer für Leistungsindikatorklassen. Definieren Sie nicht den Qualifizierer GenericPerfCtr, weil er für den ADAP-Prozess reserviert ist, der Leistungsbibliotheksdaten in WMI-Klassen überträgt.
Füllen Sie die entsprechenden Zeitstempel- und Häufigkeitseigenschaften aus, die zum Berechnen von Zählertypformeln verwendet werden.
Diese Eigenschaften werden von Win32_PerfRawData geerbt. Wenn Sie einen Hochleistungsanbieter schreiben, müssen Sie sie ausfüllen, damit die Klasse im Systemmonitor angezeigt wird.
Fügen Sie die Schlüsseleigenschaft Name in Ihre Klasse ein (diese Eigenschaft ist für Singleton-Klassen nicht erforderlich).
Sie dürfen keine andere Schlüsseleigenschaft als Name für Ihre Klasse verwenden.
Erstellen Sie Eigenschaften, die als DWORD (uint32) oder QWORD (uint64) eingegeben werden. Diese Eigenschaften werden zu Leistungsindikatoren, wenn sie an die Leistungsbibliotheken übertragen werden.
Geben Sie die folgenden Qualifizierer auf Eigenschaftsebene für alle Eigenschaften in Ihrer Klasse an:
- DisplayName
- CounterType
- DefaultScale
- Beschreibung
- PerfDefault
- PerfDetail
Weitere Informationen finden Sie unter Eigenschaftenqualifizierer für Leistungsindikatorklassen. Darüber hinaus enthält die Headerdatei „Winperf.h“ Werte, die Sie für PerfDetail und CounterType angeben können.
WMI verwendet die Qualifizierer DisplayName (Anzeigename), Locale (Gebietsschema) und Description (Beschreibung) für die Lokalisierung. Sie müssen dem Namespace „MS_409“ (Englisch) geänderte Qualifizierer hinzufügen, damit der Systemmonitor Ihre Klassendaten ordnungsgemäß anzeigen kann. Dies bedeutet, dass Sie die Eigenschaftsdefinition ändern, indem Sie einen Qualifizierer vom Typ Description mit erläuterndem Text hinzufügen und den Wert DisplayName eingeben. Geänderte Qualifizierer müssen Sie auch jedem anderen Namespace vom Typ „Locale“ hinzufügen, den Ihre Klasse unterstützt. Wenn ein Benutzer Daten aus einem Gebietsschema anfordert, für das Sie keine geänderten Qualifizierer bereitstellen, wird WMI standardmäßig auf die Definitionen festgelegt, die im Namespace „MS_409“ angegeben wurden.
Erstellen Sie eine Basiseigenschaft für jede Eigenschaft mit einem Zählertyp, der einen Basiswert erwartet.
Diese Eigenschaft folgt sofort auf die Eigenschaft und heißt „propertyname**_Base**“. Beispielsweise erfordert die Durchschnittseigenschaft AvgDiskBytesPerRead in der Klasse Win32_PerfRawData_PerfDisk_LogicalDisk die Basiseigenschaft AvgDiskBytesPerRead_Base, um die Anzahl der Beispiele zählen zu können. Zur Ermittlung, ob der zu verwendende Zählertyp eine Basiseigenschaft erfordert, suchen Sie den Zählertyp nach Name oder Dezimalwert in WMI-Leistungsindikatortypen.
Stellen Sie sicher, dass Ihr Anbieter die Leistungsanforderungen erfüllt.
Zugehörige Themen