Win32_PerfRawData_Tcpip_IP class

The Win32_PerfRawData_Tcpip_IP raw performance data class provides raw data from performance counters that monitor the rates at which IP datagrams are sent and received by using IP protocols. It also includes counters that monitor IP protocol errors.

This class represents the IP object in System Monitor. The original data source is the Tcpip performance library. The corresponding formatted data class is Win32_PerfFormattedData_Tcpip_IP. Data is dynamically provided for this class from the performance library object by the WmiPerfInst provider.

Windows Server 2003 and Windows XP: WMI data for this class is supplied by the Performance Counter Provider.

The following syntax is simplified from MOF code and shows all inherited properties, including the Frequency and Timestamp properties required for class display in System Monitor. For more information about required property qualifiers, see Property Qualifiers for Raw Performance Counter Classes. For more information about CounterType values, see WMI Performance Counter Types.

Syntax

class Win32_PerfRawData_Tcpip_IP : Win32_PerfRawData
{
  string Caption;
  uint32 DatagramsForwardedPerSec;
  uint32 DatagramsOutboundDiscarded;
  uint32 DatagramsOutboundNoRoute;
  uint32 DatagramsPerSec;
  uint32 DatagramsReceivedAddressErrors;
  uint32 DatagramsReceivedDeliveredPerSec;
  uint32 DatagramsReceivedDiscarded;
  uint32 DatagramsReceivedHeaderErrors;
  uint32 DatagramsReceivedPerSec;
  uint32 DatagramsReceivedUnknownProtocol;
  uint32 DatagramsSentPerSec;
  string Description;
  uint32 FragmentationFailures;
  uint32 FragmentedDatagramsPerSec;
  uint32 FragmentReassemblyFailures;
  uint32 FragmentsCreatedPerSec;
  uint32 FragmentsReassembledPerSec;
  uint32 FragmentsReceivedPerSec;
  uint64 Frequency_Object;
  uint64 Frequency_PerfTime;
  uint64 Frequency_Sys100NS;
  string Name;
  uint64 Timestamp_Object;
  uint64 Timestamp_PerfTime;
  uint64 Timestamp_Sys100NS;
};

Members

The Win32_PerfRawData_Tcpip_IP class has these types of members:

  • Properties

Properties

The Win32_PerfRawData_Tcpip_IP class has these properties.

Caption

Data type: string

Access type: Read-only

Short textual description for the statistic or metric. This property is inherited from CIM_StatisticalInformation.

DatagramsForwardedPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Forwarded/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate of input datagrams that were forwarded because this entity was not the final IP destination. In entities that do not act as IP gateways, this rate includes only those packets that were source-routed using this entity, and for which the source-route option processing was successful.

DatagramsOutboundDiscarded

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Outbound Discarded") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of output IP datagrams that were discarded for reasons such as lack of buffer space, despite having no problems preventing transmission to the destination. This property includes datagrams counted in DatagramsForwardedPerSec if any such packets met this discretionary discard criterion.

DatagramsOutboundNoRoute

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Outbound No Route") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of IP datagrams discarded because no route could be found to transmit them to the destination. This property includes any packets counted in DatagramsForwarded that meet the "no route" criterion.

DatagramsPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams/sec") , PerfDefault, CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP datagrams are received from or sent to the interfaces, including those in error. Any forwarded datagrams are not included in this rate.

DatagramsReceivedAddressErrors

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received Address Errors") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of input datagrams discarded because the IP address in the header of the IPdestination field was not a valid address to be received at this entity. This count includes invalid addresses (for example, 0.0. 0.0) and addresses of unsupported Classes (for example, Class E). For entities that are not IP Gateways and therefore do not forward datagrams, this property includes datagrams discarded because the destination address was not a local address.

DatagramsReceivedDeliveredPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received Delivered/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which input datagrams are successfully delivered to IP user-protocols (including ICMP).

DatagramsReceivedDiscarded

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received Discarded") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of input IP datagrams for which no problems were encountered to prevent continued processing, but which were discarded, for example, due to an insufficient buffer size. This property does not include any datagrams discarded while awaiting reassembly.

DatagramsReceivedHeaderErrors

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received Header Errors") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of input datagrams discarded due to errors in the IP headers, including bad checksums, version number mismatch, other format errors, time-to-live exceeded, errors discovered in processing IP options, and so on.

DatagramsReceivedPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP datagrams are received from the interfaces, including those in error.

DatagramsReceivedUnknownProtocol

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Received Unknown Protocol") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of locally addressed datagrams received successfully but are discarded because of an unknown or unsupported protocol.

DatagramsSentPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Datagrams Sent/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP datagrams are supplied to IP for transmission by local IP user-protocols (including ICMP). That this property does not include any datagrams counted in Datagrams Forwarded.

Description

Data type: string

Access type: Read-only

Textual description of the statistic or metric. This property is inherited from CIM_StatisticalInformation.

FragmentationFailures

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragmentation Failures") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of IP datagrams that have been discarded because they must be fragmented at this entity, but cannot be, for example, because the "Do not Fragment" flag was set.

FragmentedDatagramsPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragmented Datagrams/sec") , CounterType (272696320)

Rate at which datagrams are successfully fragmented at this entity.

FragmentReassemblyFailures

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragment Re-assembly Failures") , CounterType (65536) , DefaultScale (0) , PerfDetail (200)

Number of failures detected by the IP re-assembly algorithm for any reason, such as time out, errors, and so on. This is not necessarily a count of discarded IP fragments because some algorithms (notably RFC 815) can lose track of the number of fragments by combining them as they are received.

FragmentsCreatedPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragments Created/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP datagram fragments have been generated as a result of fragmentation at this entity.

FragmentsReassembledPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragments Re-assembled/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP fragments are successfully reassembled.

FragmentsReceivedPerSec

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Fragments Received/sec") , CounterType (272696320) , DefaultScale (-1) , PerfDetail (200)

Rate at which IP fragments that must be reassembled at this entity are received.

Frequency_Object

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Object. This property is defined by the provider. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Frequency_PerfTime

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Perftime. A value can be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Frequency_Sys100NS

Data type: uint64

Access type: Read-only

Frequency, in ticks per second, of Timestamp_Sys100NS (10000000). This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Name

Data type: string

Access type: Read-only

Qualifiers: Key, MaxLen (256)

Label by which the statistic or metric is known. This property is inherited from CIM_StatisticalInformation.

Timestamp_Object

Data type: uint64

Access type: Read-only

Object-defined timestamp, defined by the provider. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Timestamp_PerfTime

Data type: uint64

Access type: Read-only

High Performance counter timestamp. A value can be obtained by calling the Windows function QueryPerformanceCounter. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Timestamp_Sys100NS

Data type: uint64

Access type: Read-only

Timestamp value in 100 nanosecond units. This property is inherited from Win32_Perf.

For more information about using uint64 values in scripts, see Scripting in WMI.

Remarks

All classes derived from Win32_Perf are designed to be used with a refresher object. For more information about how to create and use a refresher object in C++, see Accessing Performance Data in C++. For more information about how to create and use a refresher object using scripts, see Refreshing WMI Data in Scripts.

The performance class and property qualifiers determine how to interpret the class data. For more information, see Class Qualifiers for Performance Counter Classes and Property Qualifiers for Performance Counter Classes.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

DLL

WmiPerfInst.dll; WbemPerf.dll on Windows Server 2003 and Windows XP

See also

Performance Counter Classes

Accessing WMI Preinstalled Performance Classes

WMI Tasks: Performance Monitoring

Accessing Performance Data in Script