Supporto della classe Win32_PerfRawData
Quando si scrive un provider ad alte prestazioni che deriva classi da Win32_PerfRawData, è necessario seguire convenzioni specifiche in modo che WMI possa fornire dati ai valori delle proprietà.
Nota
La scrittura di un provider WMI ad alte prestazioni per creare contatori delle prestazioni non è consigliata in alcuna versione del sistema operativo Windows. Per altre informazioni, vedere Creazione di un provider di istanze in un provider di High-Performancee librerie di prestazioni e WMI.
La procedura seguente descrive come supportare la classe Win32_PerfRawData con il provider ad alte prestazioni.
Per supportare la classe Win32_PerfRawData
Creare la classe nello spazio dei nomi Root\CIMv2.
La classe deve essere derivata da Win32_PerfRawData e avere il qualificatore Hiperf impostato su TRUE. È anche possibile aggiungere classi di dati delle prestazioni WDM (driver) allo spazio dei nomi root\wmi. Per altre informazioni sulla creazione di una classe personalizzata per WMI, vedere Progettazione di classi MOF (Managed Object Format).
Specificare il provider come "NT5_GenericPerfProvider_V1" nel qualificatore Provider.
Specificare i qualificatori a livello di classe seguenti:
- HiPerf
- Locale
- PerfDetail
- provider
Per ulteriori informazioni, vedere Qualificatori di classe per le classi di contatori di prestazioni. Non definire il qualificatore GenericPerfCtr perché è riservato per il processo ADAP che trasferisce i dati della libreria delle prestazioni in classi WMI.
Popolare le proprietà appropriate di timestamp e frequenza usate per calcolare le formule di tipo contatore.
Queste proprietà vengono ereditate da Win32_PerfRawData e, se si scrive un provider ad alte prestazioni, è necessario compilarli affinché la classe venga visualizzata in Monitoraggio di sistema.
Includere una proprietà chiave denominata Name nella classe (questa proprietà non è necessaria per le classi singleton).
Non è necessario utilizzare alcuna proprietà chiave diversa da Nome nella classe.
Creare proprietà tipizzate come DWORD (uint32) o QWORD (uint64). Queste proprietà diventano contatori delle prestazioni quando vengono trasferiti alle librerie delle prestazioni.
Specificare i qualificatori del livello di proprietà seguenti per tutte le proprietà nella classe:
- NomeVisualizzato
- CounterType
- DefaultScale
- Descrizione
- PerfDefault
- PerfDetail
Per altre informazioni, vedere Qualificatori di proprietà per le classi dei contatori delle prestazioni. Inoltre, il file di intestazione Winperf.h contiene valori che è possibile specificare per PerfDetail e CounterType.
WMI usa i qualificatori DisplayName, Localee Descrizione per la localizzazione. È necessario aggiungere qualificatori aggiornati allo spazio dei nomi MS_409 (English) in modo che System Monitor possa visualizzare correttamente i dati della classe. Ciò significa che si modifica la definizione della proprietà aggiungendo un qualificatore Descrizione con testo esplicativo e si compila il valore DisplayName. È inoltre necessario aggiungere qualificatori modificati a qualsiasi altro namespace locale che la tua classe supporta. Se un utente richiede dati da impostazioni locali per cui non si forniscono qualificatori modificati, WMI usa per impostazione predefinita le definizioni specificate nello spazio dei nomi MS_409.
Creare una proprietà di base per qualsiasi proprietà con un tipo di contatore che prevede un valore di base.
Questa proprietà segue immediatamente la proprietà precedente ed è denominata nomeproprietà**_Base**. Ad esempio, la proprietà media AvgDiskBytesPerRead nella classe Win32_PerfRawData_PerfDisk_LogicalDisk richiede una proprietà di base denominata AvgDiskBytesPerRead_Base per contare il numero di campioni. Per determinare se il tipo di contatore che si desidera utilizzare richiede una proprietà di base, individuare il tipo di contatore in base al nome o al valore decimale in tipi di contatore delle prestazioni WMI.
Assicurarsi che il provider soddisfi i requisiti di prestazioni .
Argomenti correlati