Bewerken

Delen via

OID_WAN_CO_GET_STATS_INFO

  • Artikel

The OID_WAN_CO_GET_STATS_INFO OID requests the miniport driver to return statistics information that is specific to a virtual connection (VC). A WAN miniport driver is expected to keep statistics and to return these statistics for this OID in an NDIS_WAN_CO_GET_STATS_INFO structure, defined as follows:

    typedef struct _NDIS_WAN_CO_GET_STATS_INFO {
         OUT ULONG BytesSent;
         OUT ULONG BytesRcvd;
         OUT ULONG FramesSent;
         OUT ULONG FramesRcvd;
         OUT ULONG CRCErrors;
         OUT ULONG TimeoutErrors;
         OUT ULONG AlignmentErrors;
         OUT ULONG SerialOverrunErrors;
         OUT ULONG FramingErrors;
         OUT ULONG BufferOverrunErrors;
         OUT ULONG BytesTransmittedUncompressed;
         OUT ULONG BytesReceivedUncompressed;
         OUT ULONG BytesTransmittedCompressed;
         OUT ULONG BytesReceivedCompressed;
    } NDIS_WAN_CO_GET_STATS_INFO,   *PNDIS_WAN_CO_GET_STATS_INFO;

The members of this structure contain the following information:

BytesSent
Specifies the number of bytes transmitted.

BytesRcvd
Specifies the number of bytes received.

FramesSent
Specifies the number of frames (WAN packets) sent.

FramesRcvd
Specifies the number of frames received.

CRCErrors
Specifies the number of CRC errors encountered for this VC. CRC errors are caused by the failure of a cyclic redundancy check. A CRC error indicates that one or more bytes in the frame received were found garbled on arrival.

TimeoutErrors
Specifies the number of time-out errors encountered for this VC. Time-out errors occur when an expected byte is not received in time.

AlignmentErrors
Specifies the number of alignment errors encountered for this VC. Alignment errors occur when a byte received is different from the byte expected. This typically happens when a byte is lost or when a time-out error occurs.

SerialOverrunErrors
Specifies the number of serial overruns encountered for this VC. Serial overruns occur when the WAN NIC cannot handle the rate at which data is received.

FramingErrors
Specifies the number of framing errors encountered for this VC. A framing error occurs when an asynchronous byte is received with an invalid start or stop bit.

BufferOverrunErrors
Specifies the number of buffer overruns encountered for this VC. Buffer overruns occur when the WAN miniport driver cannot handle the rate at which data is received.

BytesTransmittedUncompressed
Specifies the number of bytes of uncompressed data transmitted. A miniport driver returns a nonzero value only if it supports compression.

BytesReceivedUncompressed
Specifies the number of bytes of uncompressed data received. A miniport driver returns a nonzero value only if it supports compression.

BytesTransmittedCompressed
Specifies the number of bytes of compressed data transmitted. A miniport driver returns a nonzero value only if it supports compression.

BytesReceivedCompressed
Specifies the number of bytes of compressed data received. A miniport driver returns a nonzero value only if it supports compression.

Remarks

If the underlying driver or its NIC does not support compression, the driver returns zero for the Bytes..Uncompressed/Compressed members.

Requirements

Version

Supported for NDIS 6.0 and NDIS 5.1 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows XP.

Header

 Ntddndis.h (include Ndis.h)