NIC_STATISTICS

  • Article

This structure supports a NIC statistics query through IOCTL_NDISUIO_NIC_STATISTICS.

typedef struct {
  ULONG Size;
  PTCHAR ptcDeviceName;
  ULONG DeviceState;
  ULONG MediaType;
  ULONG MediaState;
  ULONG PhysicalMediaType;
  ULONG LinkSpeed;
  ULONGLONG PacketsSent;
  ULONGLONG PacketsReceived;
  ULONG InitTime;
  ULONG ConnectTime;
  ULONGLONG BytesSent;
  ULONGLONG BytesReceived;
  ULONGLONG DirectedBytesReceived;
  ULONGLONG DirectedPacketsReceived;
  ULONG PacketsReceiveErrors;
  ULONG PacketsSendErrors;
  ULONG ResetCount;
  ULONG MediaSenseConnectCount;
  ULONG MediaSenseDisconnectCount;
} NIC_STATISTICS, *PNIC_STATISTICS;

Members

  • Size
    Size of the NIC_STATISTICS structure.

  • ptcDeviceName
    Device name to query.

  • DeviceState
    Result of the NDISUIO query of OID_GEN_MEDIA_IN_USE.

    The following table shows the valid DeviceState values.

    State Value
    DEVICE_STATE_CONNECTED 1
    DEVICE_STATE_DISCONNECTED 0

  • MediaType
    NDISMediumxxx value. The following table shows the valid NDIS medium values for MediaType.

    NdisMediumxxx Description
    NdisMedium802_3 Specifies an Ethernet (802.3) medium.
    NdisMedium802_5 Not supported for NDISUIO. Specifies a Token Ring (802.5) medium.
    NdisMediumWan Not supported for NDISUIO. Specifies a WAN.
    NdisMediumDix Not supported for NDISUIO. Specifies DEC/Intel/Xerox (DIX) Ethernet medium.
    NdisMediumWirelessWan Not supported for NDISUIO. Specifies various types of wireless medium.
    NdisMediumIrda Not supported for NDISUIO. Specifies an infrared (IrDA) medium.
    NdisMediumBpc Not supported for NDISUIO. Specifies a broadcast architecture medium.
    NdisMediumCoWan Not supported for NDISUIO. Specifies a connection-oriented WAN medium, which is not supported.
    NdisMedium1394 Not supported for NDISUIO. Specifies an IEEE 1394 medium.
    NdisMediumMax Not supported for NDISUIO. Specifies an upper bound.

  • MediaState
    Result of the NDISUIO query of OID_GEN_MEDIA_CONNECT_STATUS. The following table shows the valid MediaState values.

    Media state Value
    MEDIA_STATE_CONNECTED 0
    MEDIA_STATE_DISCONNECTED 1
    MEDIA_STATE_UNKNOWN -1

  • PhysicalMediaType
    Result of the NDISUIO query of OID_GEN_PHYSICAL_MEDIUM.

  • LinkSpeed
    Result of the NDISUIO query of OID_GEN_LINK_SPEED. This is the speed of the link in 100 bits/s. For example, 10 Mb/s = 100000.

  • PacketsSent
    Result of the NDISUIO query of OID_GEN_XMIT_OK. For more information about OID_GEN_XMIT_OK, see OID_GEN_SUPPORTED_LIST.

  • PacketsReceived
    Result of the NDISUIO query of OID_GEN_RCV_OK. For more information about OID_GEN_RECV_OK, see OID_GEN_SUPPORTED_LIST.

  • InitTime
    Result of the NDISUIO query of OID_GEN_INIT_TIME_MS. This is the initialization time, in milliseconds. For more information about OID_GEN_INIT_TIME_MS, see OID_GEN_SUPPORTED_LIST.

  • ConnectTime
    Result of the NDISUIO query of OID_GEN_ELAPSED_TIME. This is the connection time, in seconds. For more information about OID_GEN_ELAPSED_TIME, see OID_GEN_SUPPORTED_LIST.

  • BytesSent
    Result of the NDISUIO query of OID_GEN_XMIT_OK, where 0 indicates unknown, or not supported. For more information about OID_GEN_XMIT_OK, see OID_GEN_SUPPORTED_LIST.

  • BytesReceived
    Result of the NDISUIO query of OID_GEN_RCV_OK, where 0 indicates unknown, or not supported. For more information about OID_GEN_RECV_OK, see OID_GEN_SUPPORTED_LIST.

  • DirectedBytesReceived
    Result of the NDISUIO query of OID_GEN_DIRECTED_BYTES_RCV. For more information about OID_GEN_DIRECTED_BYTES_RCV, see OID_GEN_SUPPORTED_LIST.

  • DirectedPacketsReceived
    Result of the NDISUIO query of OID_GEN_DIRECTED_FRAMES_RCV. For more information about OID_GEN_DIRECTED_FRAMES_RCV, see OID_GEN_SUPPORTED_LIST.

  • PacketsReceiveErrors
    Result of the NDISUIO query of OID_GEN_RCV_ERROR. For more information about OID_GEN_RCV_ERROR, see OID_GEN_SUPPORTED_LIST.

  • PacketsSendErrors
    Result of the NDISUIO query of OID_GEN_XMIT_ERROR. For more information about OID_GEN_XMIT_ERROR, see OID_GEN_SUPPORTED_LIST.

  • ResetCount
    Result of the NDISUIO query of OID_GEN_RESET_COUNTS. For more information about OID_GEN_RESET_COUNTS, see OID_GEN_SUPPORTED_LIST.

  • MediaSenseConnectCount
    Result of the NDISUIO query of OID_GEN_MEDIA_SENSE_COUNTS. For more information about OID_GEN_MEDIA_SENSE_COUNTS, see OID_GEN_SUPPORTED_LIST.

  • MediaSenseDisconnectCount
    Result of the NDISUIO query of OID_GEN_MEDIA_SENSE_COUNTS. For more information about OID_GEN_MEDIA_SENSE_COUNTS, see OID_GEN_SUPPORTED_LIST.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Nuiouser.h.

See Also

IOCTL_NDISUIO_NIC_STATISTICS | OID_GEN_PHYSICAL_MEDIUM | OID_GEN_SUPPORTED_LIST | OID_GEN_MEDIA_CONNECT_STATUS | OID_GEN_LINK_SPEED | OID_GEN_MEDIA_IN_USE

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.