Udostępnij przez

FormatFromRawValue, funkcja

Konwertuje jedną nieprzetworzone dane wydajności na określony format lub dwie nieprzetworzone wartości danych wydajności, jeśli konwersja formatu jest oparta na czasie.

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest ona przeznaczona do użycia z kodu dewelopera.

Składnia

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
);

Parametry

dwCounterType
[w] Typ licznika. Aby uzyskać listę typów liczników, zobacz Typy liczników wydajności usługi WMI. dwCounterType może być dowolnym typem licznika z wyjątkiem i PERF_LARGE_RAW_FRACTIONPERF_LARGE_RAW_BASE.

dwFormat
[w] Format, do którego mają być konwertowane nieprzetworzone dane wydajności. Może to być jedna z następujących wartości:

Stała Wartość Opis
PDH_FMT_DOUBLE 0x00000200 Zwróć wartość obliczeniową jako wartość zmiennoprzecinkową o podwójnej precyzji.
PDH_FMT_LARGE 0x00000400 Zwróć wartość obliczeniową jako 64-bitową liczbę całkowitą.
PDH_FMT_LONG 0x00000100 Zwróć wartość obliczeniową jako 32-bitową liczbę całkowitą.

Jedną z poprzednich wartości może być ORed z jedną z następujących flag skalowania:

Stała Wartość Opis
PDH_FMT_NOSCALE 0x00001000 Nie należy stosować czynników skalowania licznika.
PDH_FMT_1000 0x00002000 Pomnóż końcową wartość o 1000.

pTimeBase
[w] Wskaźnik do bazy czasu, jeśli jest to konieczne dla konwersji formatu. Jeśli informacje o bazie czasu nie są niezbędne do konwersji formatu, wartość tego parametru jest ignorowana.

pRawValue1
[w] Wskaźnik do PDH_RAW_COUNTER struktury reprezentującej nieprzetworzone wartości wydajności.

pRawValue2
[w] Wskaźnik do PDH_RAW_COUNTER struktury reprezentującej drugą nieprzetworzonej wartości wydajności. Jeśli druga nieprzetworzona wartość wydajności nie jest konieczna, ten parametr powinien mieć wartość null.

pFmtValue
[out] Wskaźnik do PDH_FMT_COUNTERVALUE struktury, która odbiera sformatowaną wartość wydajności.

Wartość zwracana

Następujące wartości są zwracane przez tę funkcję:

Stała Wartość Opis
ERROR_SUCCESS 0 Wywołanie funkcji zakończyło się pomyślnie.
PDH_INVALID_ARGUMENT 0xC0000BBD Brak wymaganego argumentu lub jest on nieprawidłowy.
PDH_INVALID_HANDLE 0xC0000BBC Uchwyt nie jest prawidłowym obiektem PDH.

Uwagi

Ta funkcja zawija wywołanie funkcji FormatFromRawValue .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Biblioteka: PerfCounter.dll

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on