Aracılığıyla paylaş


FormatFromRawValue işlevi

Bir ham performans veri değerini belirtilen biçime veya biçim dönüştürmesi zamana bağlıysa iki ham performans verisi değerine dönüştürür.

Not

Bu API yalnızca iç kullanıma yöneliktir. Geliştirici kodundan kullanılmak üzere tasarlanmamıştır.

Sözdizimi

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Parametreler

dwCounterType
[in] Sayaç türü. Sayaç türlerinin listesi için bkz. WMI Performans Sayacı Türleri. dwCounterTypeve PERF_LARGE_RAW_BASEdışında PERF_LARGE_RAW_FRACTION herhangi bir sayaç türü olabilir.

dwFormat
[in] Ham performans verilerinin dönüştürüldüğü biçim. Aşağıdaki değerlerden biri olabilir:

Sabit Değer Açıklama
PDH_FMT_DOUBLE 0x00000200 Hesaplanan değeri çift duyarlıklı kayan nokta değeri olarak döndürür.
PDH_FMT_LARGE 0x00000400 Hesaplanan değeri 64 bit tamsayı olarak döndürür.
PDH_FMT_LONG 0x00000100 Hesaplanan değeri 32 bit tamsayı olarak döndürür.

Önceki değerlerden biri aşağıdaki ölçeklendirme bayraklarından biriyle ORed olabilir:

Sabit Değer Açıklama
PDH_FMT_NOSCALE 0x00001000 Sayacın ölçeklendirme faktörlerini uygulamayın.
PDH_FMT_1000 0x00002000 Son değeri 1.000 ile çarpın.

pTimeBase
[in] Biçim dönüştürme için gerekirse zaman tabanına yönelik bir işaretçi. Biçim dönüştürme için zaman temeli bilgileri gerekli değilse, bu parametrenin değeri yoksayılır.

pRawValue1
[in] Ham performans değerini temsil eden bir PDH_RAW_COUNTER yapıya işaretçi.

pRawValue2
[in] İkinci bir ham performans değerini temsil eden bir PDH_RAW_COUNTER yapıya işaretçi. İkinci bir ham performans değeri gerekli değilse, bu parametre olmalıdır null.

pFmtValue
[out] Biçimlendirilmiş performans değerini alan bir yapıya yönelik işaretçi PDH_FMT_COUNTERVALUE .

Döndürülen değer

Bu işlev tarafından aşağıdaki değerler döndürülür:

Sabit Değer Açıklama
ERROR_SUCCESS 0 İşlev çağrısı başarılı.
PDH_INVALID_ARGUMENT 0xC0000BBD Gerekli bir bağımsız değişken eksik veya yanlış.
PDH_INVALID_HANDLE 0xC0000BBC Tanıtıcı geçerli bir PDH nesnesi değil.

Açıklamalar

Bu işlev , FormatFromRawValue işlevine yapılan çağrıyı sarmalar.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Kitaplık: PerfCounter.dll

.NET Framework Sürümleri: 4.7.2 sürümünden itibaren kullanılabilir

Ayrıca bkz.