RAS_STATS

The RAS_STATS structure stores the statistics for a single-link RAS connection, or for one of the links in a multilink RAS connection.

typedef struct _RAS_STATS {
  DWORD   dwSize;
  DWORD   dwBytesXmited;
  DWORD   dwBytesRcved;
  DWORD   dwFramesXmited;
  DWORD   dwFramesRcved;
  DWORD   dwCrcErr;
  DWORD   dwTimeoutErr;
  DWORD   dwAlignmentErr;
  DWORD   dwHardwareOverrunErr;
  DWORD   dwFramingErr;
  DWORD   dwBufferOverrunErr;
  DWORD   dwCompressionRatioIn;
  DWORD   dwCompressionRatioOut;
  DWORD   dwBps;
  DWORD   dwConnectDuration;
} RAS_STATS, *PRAS_STATS;

Members

dwSize

Specifies the version of the structure. Set this member to sizeof(RAS_STATS) before using the structure in a function call.

dwBytesXmited

The number of bytes transmitted through this connection or link.

dwBytesRcved

The number of bytes received through this connection or link.

dwFramesXmited

The number frames transmitted through this connection or link.

dwFramesRcved

The number of frames received through this connection or link.

dwCrcErr

The number of cyclic redundancy check (CRC) errors on this connection or link.

dwTimeoutErr

The number of timeout errors on this connection or link.

dwAlignmentErr

The number of alignment errors on this connection or link.

dwHardwareOverrunErr

The number of hardware overrun errors on this connection or link.

dwFramingErr

The number of framing errors on this connection or link.

dwBufferOverrunErr

The number of buffer overrun errors on this connection or link.

dwCompressionRatioIn

The compression ratio for the data being received on this connection or link.

dwCompressionRatioOut

The compression ratio for the data being transmitted on this connection or link.

dwBps

The speed of the connection or link, in bits per second.

For a single-link connection and for individual links in a multilink connection, this speed is negotiated at the time the connection or link is established.

For multilink connections, this speed is equal to the sum of the speeds of the individual links. For multilink connections, this speed will vary as links are added or deleted.

This speed is not equal to the throughput of the connection or link. To calculate the average throughput, divide the number of bytes transmitted (dwBytesXmited) and received (dwBytesRcved) by the amount of time the connection or link has been up (dwConnectDuration).

dwConnectDuration

The amount of time, in seconds, that the connection or link has been connected.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Ras.h.

See Also

Remote Access Service (RAS) Overview, RAS Server Administration Structures, RasClearConnectionStatistics, RasClearLinkStatistics, RasGetConnectionStatistics, RasGetLinkStatistics