Compartir a través de


Compatibilidad con la clase Win32_PerfRawData

Al escribir un proveedor de alto rendimiento que derive clases de Win32_PerfRawData, debe seguir unas convenciones específicas para que WMI pueda proporcionar datos a los valores de propiedad.

Nota

No se recomienda escribir un proveedor de alto rendimiento de WMI para crear contadores de rendimiento en ninguna versión del sistema operativo Windows. Para obtener más información, consulte Convertir un proveedor de instancias en un proveedor de alto rendimiento y Bibliotecas de rendimiento y WMI.

 

En el procedimiento siguiente se describe cómo compatibilizar la clase Win32_PerfRawData con el proveedor de alto rendimiento.

Para compatibilizar la clase Win32_PerfRawData

  1. Cree la clase en el espacio de nombres Root\CIMv2.

    La clase debe derivarse de Win32_PerfRawData y tener el calificador Hiperf establecido en TRUE. También puede agregar clases de datos de rendimiento de WDM (controlador) al espacio de nombres root\wmi. Para obtener más información sobre cómo crear su propia clase para WMI, consulte Diseñar clases de formato de objeto administrado (MOF).

  2. Especifique el proveedor como "NT5_GenericPerfProvider_V1" en el calificador Provider.

  3. Especifique los siguientes calificadores de nivel de clase:

    • HiPerf
    • Configuración regional
    • PerfDetail
    • Proveedor

    Para obtener más información, consulte Calificadores de clase para clases de contador de rendimiento. No defina el calificador GenericPerfCtr porque está reservado para el proceso de ADAP que transfiere los datos de la biblioteca de rendimiento a las clases de WMI.

  4. Rellene las propiedades de marca de tiempo y frecuencia adecuadas que se usan para calcular fórmulas de tipo contador.

    Estas propiedades se heredan de Win32_PerfRawData y, si está escribiendo un proveedor de alto rendimiento, debe rellenarlas para que la clase se muestre en el Monitor del sistema.

  5. Incluya una propiedad de clave denominada Name en la clase (esta propiedad no es necesaria para las clases singleton).

    No debe usar ninguna propiedad de clave que no sea Name en la clase.

  6. Cree propiedades con tipo de datos como DWORD (uint32) o QWORD (uint64). Estas propiedades se convierten en contadores de rendimiento cuando se transfieren a las bibliotecas de rendimiento.

  7. Especifique los siguientes calificadores de nivel de propiedad para todas las propiedades de la clase:

    • DisplayName
    • CounterType
    • DefaultScale
    • Descripción
    • PerfDefault
    • PerfDetail

    Para obtener más información, consulte Calificadores de propiedad para clases de contador de rendimiento. Además, el archivo de encabezado Winperf.h contiene valores que se pueden especificar para PerfDetail y CounterType.

    WMI usa los calificadores DisplayName, Locale y Description para la localización. Debe agregar calificadores modificados al espacio de nombres MS_409 (inglés) para que el Monitor del sistema pueda mostrar correctamente los datos de clase. Esto significa que se modifica la definición de propiedad agregando un calificador Description con texto explicativo y rellenando el valor de DisplayName. También debe agregar calificadores modificados a cualquier otro espacio de nombres de configuración regional que admita la clase. Si un usuario solicita datos de una configuración regional para la que no se proporcionan calificadores modificados, WMI tiene como valor predeterminado las definiciones especificadas en el espacio de nombres MS_409.

  8. Cree una propiedad base para cualquier propiedad que tenga un tipo de contador que espere un valor base.

    Esta propiedad sigue inmediatamente a la propiedad y se denomina propertyname**_Base**. Por ejemplo, la propiedad de promedio AvgDiskBytesPerRead de la clase Win32_PerfRawData_PerfDisk_LogicalDisk requiere una propiedad base denominada AvgDiskBytesPerRead_Base para contar el número de muestras. Para determinar si el tipo de contador que quiere usar requiere una propiedad base, localice el tipo de contador por nombre o valor decimal en Tipos de contador de rendimiento de WMI.

  9. Asegúrese de que el proveedor cumple los requisitos de rendimiento.

Convertir un proveedor de instancias en un proveedor de alto rendimiento