CounterSample

CounterSample

---

System.Diagnostics (system.dll)

struct

This structure contains a performance counter's raw data. It represents a sample taken at a particular point in time (the CounterTimeStamp property). Calculate( ) returns a counter's performance data as a float value. The two-argument form returns values for calculated performance counters, such as averages.

TimeStamp and TimeStamp100nSec return the system timestamp, with varying degrees of accuracy. ( TimeStamp100nSec is the most precise, reporting a timestamp within .1 milliseconds .) BaseValue specifies a base raw value for samples based on multiple counters. RawValue contains the sample's numeric value. SystemFrequency represents how often the system reads the counter, and CounterFrequency represents how often samples are taken by the counter. Both frequencies are represented in milliseconds..

Figure 29-3. TraceListener and related classes

 public struct  CounterSample  {  // Public Constructors  public  CounterSample  (long   rawValue   , long   baseValue   , long   counterFrequency   , long   systemFrequency   ,          long   timeStamp   , long   timeStamp100nSec   , PerformanceCounterType   counterType   );    public  CounterSample  (long   rawValue   , long   baseValue   , long   counterFrequency   , long   systemFrequency   ,          long   timeStamp   , long   timeStamp100nSec   , PerformanceCounterType   counterType   , long   counterTimeStamp   );  // Public Static Fields  public static CounterSample  Empty  ;  // =System.Diagnostics.CounterSample   // Public Instance Properties  public long  BaseValue  {get; }    public long  CounterFrequency  {get; }    public long  CounterTimeStamp  {get; }    public PerformanceCounterType  CounterType  {get; }    public long  RawValue  {get; }    public long  SystemFrequency  {get; }    public long  TimeStamp  {get; }    public long  TimeStamp100nSec  {get; }  // Public Static Methods  public static float  Calculate  (CounterSample   counterSample   );    public static float  Calculate  (CounterSample   counterSample   , CounterSample   nextCounterSample   ); } 

Hierarchy

System.Object System.ValueType CounterSample

Returned By

InstanceData.Sample , PerformanceCounter.NextSample( )

Passed To

CounterSampleCalculator.ComputeCounterValue( ) , InstanceData.InstanceData( )

Figure 29-4. CodeAccessSecurityAttributes, collections, and related classes