Condividi tramite

Supporto della classe Win32_PerfRawData

  • Articolo

Quando si scrive un provider ad alte prestazioni che deriva dalle 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 nessuna 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

  1. 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).

  2. Specificare il provider come "NT5_GenericPerfProvider_V1" nel qualificatore provider .

  3. Specificare i qualificatori a livello di classe seguenti:

    • HiPerf
    • Impostazioni locali
    • PerfDetail
    • Provider

    Per altre informazioni, vedere Qualificatori di classe per classi contatori prestazioni. Non definire il qualificatore GenericPerfCtr perché è riservato per il processo ADAP che trasferisce i dati della libreria delle prestazioni nelle classi WMI.

  4. Popolare le proprietà di timestamp e frequenza appropriate usate per calcolare le formule di contatore.

    Queste proprietà vengono ereditate da Win32_PerfRawData e, se si scrive un provider ad alte prestazioni, è necessario compilare queste proprietà per la classe da visualizzare in Monitoraggio sistema.

  5. Includere una proprietà chiave denominata Name nella classe (questa proprietà non è necessaria per le classi singleton).

    Non è necessario usare alcuna proprietà chiave diversa da Name nella classe.

  6. Creare proprietà digitate come DWORD (uint32) o QWORD (uint64). Queste proprietà diventano contatori delle prestazioni quando vengono trasferiti nelle librerie delle prestazioni.

  7. Specificare i qualificatori a livello di proprietà seguenti per tutte le proprietà nella classe:

    • DisplayName
    • CounterType
    • DefaultScale
    • Descrizione
    • PerfDefault
    • PerfDetail

    Per altre informazioni, vedere Qualificatori delle proprietà per le classi di contatori delle prestazioni. Inoltre, il file di intestazione Winperf.h contiene valori che è possibile specificare per PerfDetail e CounterType.

    WMI usa i qualificatori DisplayName, Impostazioni locali e Descrizione per la localizzazione. È necessario aggiungere qualificatori modificati allo spazio dei nomi MS_409 (inglese) in modo che Monitoraggio sistema possa visualizzare correttamente i dati della classe. Ciò significa che si modifica la definizione della proprietà aggiungendo un qualificatore Description con testo esplicativo e compilare il valore DisplayName . È anche necessario aggiungere qualificatori modificati a qualsiasi altro spazio dei nomi delle impostazioni locali supportate dalla classe. Se un utente richiede dati da impostazioni locali per cui non vengono forniti qualificatori modificati, WMI viene predefinito per le definizioni specificate nello spazio dei nomi MS_409.

  8. 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à ed è denominata propertyname**_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 esempi. Per determinare se il tipo di contatore da usare richiede una proprietà di base, individuare il tipo di contatore in base al nome o al valore decimale nei tipi di contatore delle prestazioni WMI.

  9. Assicurarsi che il provider soddisfi i requisiti di prestazioni.

Creazione di un provider di istanze in un provider di High-Performance