Skip to content

Latest commit

 

History

History
406 lines (236 loc) · 14.8 KB

ns-ifdef-ndis_interface_information.md

File metadata and controls

406 lines (236 loc) · 14.8 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:ifdef._NDIS_INTERFACE_INFORMATION
NDIS_INTERFACE_INFORMATION (ifdef.h)
The NDIS_INTERFACE_INFORMATION structure provides information about a network interface for the OID_GEN_INTERFACE_INFO OID.
*PNDIS_INTERFACE_INFORMATION
NDIS_INTERFACE_INFORMATION
NDIS_INTERFACE_INFORMATION structure [Network Drivers Starting with Windows Vista]
PNDIS_INTERFACE_INFORMATION
PNDIS_INTERFACE_INFORMATION structure pointer [Network Drivers Starting with Windows Vista]
ifdef/NDIS_INTERFACE_INFORMATION
ifdef/PNDIS_INTERFACE_INFORMATION
net_if_struct_ref_7b31aa66-635c-4992-b5d6-301c004bdc8a.xml
netvista.ndis_interface_information_str
netvista\ndis_interface_information_str.htm
NetVista
9bfcd319-faff-4bae-8653-511154c19863
12/05/2018
*PNDIS_INTERFACE_INFORMATION, NDIS_INTERFACE_INFORMATION, NDIS_INTERFACE_INFORMATION structure [Network Drivers Starting with Windows Vista], PNDIS_INTERFACE_INFORMATION, PNDIS_INTERFACE_INFORMATION structure pointer [Network Drivers Starting with Windows Vista], ifdef/NDIS_INTERFACE_INFORMATION, ifdef/PNDIS_INTERFACE_INFORMATION, net_if_struct_ref_7b31aa66-635c-4992-b5d6-301c004bdc8a.xml, netvista.ndis_interface_information_str
ifdef.h
Ndis.h
Windows
Supported for NDIS 6.0 drivers in Windows Vista.
Windows
NDIS_INTERFACE_INFORMATION, *PNDIS_INTERFACE_INFORMATION
19H1
_NDIS_INTERFACE_INFORMATION
ifdef/_NDIS_INTERFACE_INFORMATION
PNDIS_INTERFACE_INFORMATION
ifdef/PNDIS_INTERFACE_INFORMATION
NDIS_INTERFACE_INFORMATION
ifdef/NDIS_INTERFACE_INFORMATION
c++
APIRef
kbSyntax
HeaderDef
ifdef.h
NDIS_INTERFACE_INFORMATION

NDIS_INTERFACE_INFORMATION structure

-description

The NDIS_INTERFACE_INFORMATION structure provides information about a network interface for the OID_GEN_INTERFACE_INFO OID.

-struct-fields

-field ifOperStatus

The operational status of the interface. This status is the same as the value that the OID_GEN_OPERATIONAL_STATUS OID returns.

-field ifOperStatusFlags

The operational status flags of the interface. This field is reserved for the NDIS proxy interface provider. Other interface providers should set this member to zero.

-field MediaConnectState

The NET_IF_MEDIA_CONNECT_STATE connection state type.

-field MediaDuplexState

The media duplex state of the interface. This state is the same as the value that the OID_GEN_MEDIA_DUPLEX_STATE OID returns.

-field ifMtu

The maximum transmission unit (MTU) of the interface. This MTU is the same as the value that the OID_GEN_MAXIMUM_FRAME_SIZE OID returns.

-field ifPromiscuousMode

A Boolean value that is TRUE if the interface is in promiscuous mode or FALSE if it is not. This value is the same as the value that OID_GEN_PROMISCUOUS_MODE OID query returns.

-field ifDeviceWakeUpEnable

A Boolean value that is TRUE if the interface supports wake-on-LAN capability and the capability is enabled, or FALSE if it does not.

-field XmitLinkSpeed

The transmit link speed, in bytes per second, of the interface. This speed is the same as the value that an OID_GEN_XMIT_LINK_SPEED OID query returns.

-field RcvLinkSpeed

The receive link speed, in bytes per second, of the interface. This speed is the same as the value that an OID_GEN_RCV_LINK_SPEED OID query returns.

-field ifLastChange

The time that the interface entered its current operational state. This time is the same as the value that an OID_GEN_LAST_CHANGE OID query returns.

-field ifCounterDiscontinuityTime

The time of the last discontinuity of the interface's counters. This time is the same as the value that an OID_GEN_DISCONTINUITY_TIME OID query returns.

-field ifInUnknownProtos

The number of packets that were received through the interface and that were discarded because of an unknown or unsupported protocol. This number is the same as the value that an OID_GEN_UNKNOWN_PROTOS OID query returns.

-field ifInDiscards

The number of inbound packets that were discarded even though no errors had been detected to prevent them from being deliverable to a higher-layer protocol. This number is the same as the value that an OID_GEN_RCV_DISCARDS OID query returns.

-field ifInErrors

The number of inbound packets that contained errors that prevented them from being deliverable to a higher layer protocol. This number is the same as the value that an OID_GEN_RCV_ERROR OID query returns.

-field ifHCInOctets

The total number of bytes that are received on this interface. This number is the same as the value that an OID_GEN_BYTES_RCV OID returns.

-field ifHCInUcastPkts

The number of directed packets that are received without errors on the interface. This number is the same as the value that an OID_GEN_DIRECTED_FRAMES_RCV OID query returns.

-field ifHCInMulticastPkts

The number of multicast/functional packets that are received without errors on the interface. This number is the same as the value that an OID_GEN_MULTICAST_FRAMES_RCV OID query returns.

-field ifHCInBroadcastPkts

The number of broadcast packets that are received without errors on the interface. This number is the same as the value that an OID_GEN_BROADCAST_FRAMES_RCV OID query returns.

-field ifHCOutOctets

The number of bytes that are transmitted without errors on the interface. This number is the same as the value that an OID_GEN_BYTES_XMIT OID query returns.

-field ifHCOutUcastPkts

The number of directed packets that are transmitted without errors on the interface. This number is the same as the value that an OID_GEN_DIRECTED_FRAMES_XMIT OID query returns.

-field ifHCOutMulticastPkts

The number of multicast/functional packets that are transmitted without errors on the interface. This number is the same as the value that an OID_GEN_MULTICAST_FRAMES_XMIT OID query returns.

-field ifHCOutBroadcastPkts

The number of broadcast packets that are transmitted without errors on the interface. This number is the same as the value that an OID_GEN_BROADCAST_FRAMES_XMIT OID query returns.

-field ifOutErrors

The number of packets that the interface fails to transmit. This number is the same as the value that an OID_GEN_XMIT_ERROR OID query returns.

-field ifOutDiscards

The number of packets that the interface discards. This number is the same as the value that an OID_GEN_XMIT_DISCARDS OID query returns.

-field ifHCInUcastOctets

The number of bytes in directed packets that are received without errors. This count is the same value that OID_GEN_DIRECTED_BYTES_RCV returns.

-field ifHCInMulticastOctets

The number of bytes in multicast/functional packets that are received without errors. This count is the same value that OID_GEN_MULTICAST_BYTES_RCV returns.

-field ifHCInBroadcastOctets

The number of bytes in broadcast packets that are received without errors. This count is the same value that OID_GEN_BROADCAST_BYTES_RCV returns.

-field ifHCOutUcastOctets

The number of bytes in directed packets that are transmitted without errors. This count is the same value that OID_GEN_DIRECTED_BYTES_XMIT returns.

-field ifHCOutMulticastOctets

The number of bytes in multicast/functional packets that are transmitted without errors. This count is the same value that OID_GEN_MULTICAST_BYTES_XMIT returns.

-field ifHCOutBroadcastOctets

The number of bytes in broadcast packets that are transmitted without errors. This count is the same value that OID_GEN_BROADCAST_BYTES_XMIT returns.

-field CompartmentId

The compartment that the interface belongs to, if the interface provider can provide the ID of the compartment to which the interface belongs. Otherwise, it should return NET_IF_COMPARTMENT_ID_UNSPECIFIED. If the interface provider returns NET_IF_COMPARTMENT_ID_UNSPECIFIED for the compartment ID, NDIS will return the right compartment ID for this interface.

-field SupportedStatistics

The supported statistics. For more information, see the SupportedStatistics member of the NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure.

-remarks

NDIS interface providers populate an NDIS_INTERFACE_INFORMATION structure in response to a query of the OID_GEN_INTERFACE_INFO OID. This structure contains information that changes during the lifetime of the interface.

To register as an interface provider, an NDIS driver calls the NdisIfRegisterProvider function.

-see-also

Introduction to Network Drivers

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NET_IF_MEDIA_CONNECT_STATE

NdisIfRegisterProvider

OID_GEN_BROADCAST_BYTES_RCV

OID_GEN_BROADCAST_BYTES_XMIT

OID_GEN_BROADCAST_FRAMES_RCV

OID_GEN_BROADCAST_FRAMES_XMIT

OID_GEN_BYTES_RCV

OID_GEN_BYTES_XMIT

OID_GEN_DIRECTED_BYTES_RCV

OID_GEN_DIRECTED_BYTES_XMIT

OID_GEN_DIRECTED_FRAMES_RCV

OID_GEN_DIRECTED_FRAMES_XMIT

OID_GEN_DISCONTINUITY_TIME

OID_GEN_INTERFACE_INFO

OID_GEN_LAST_CHANGE

OID_GEN_MAXIMUM_FRAME_SIZE

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_MEDIA_DUPLEX_STATE

OID_GEN_MULTICAST_BYTES_RCV

OID_GEN_MULTICAST_BYTES_XMIT

OID_GEN_MULTICAST_FRAMES_RCV

OID_GEN_MULTICAST_FRAMES_XMIT

OID_GEN_OPERATIONAL_STATUS

OID_GEN_PROMISCUOUS_MODE

OID_GEN_RCV_DISCARDS

OID_GEN_RCV_ERROR

OID_GEN_RCV_LINK_SPEED

OID_GEN_UNKNOWN_PROTOS

OID_GEN_XMIT_DISCARDS

OID_GEN_XMIT_ERROR

OID_GEN_XMIT_LINK_SPEED