NET_LUID union

A NET_LUID union can be accessed as a 64-bit value that identifies an NDIS network interface or as a structure that contains the associated interface index and type.

Syntax


union NET_LUID {
  ULONG64 Value;
  struct {
    ULONG64 Reserved  :24;
    ULONG64 NetLuidIndex  :24;
    ULONG64 IfType  :16;
  } Info;
};

Members

Value

The complete NET_LUID 64 bit value that includes an index and interface type.

Info

A bit field within the NET_LUID union that allows access to the fields in the NET_LUID value through a union with the Value member.

The Info bit field contains the following members:

Reserved

Reserved for NDIS.

NetLuidIndex

A 24-bit index that NDIS allocates when an interface provider calls the NdisIfAllocateNetLuidIndex function. This index is used to distinguish between multiple interfaces that have the same interface type. Therefore, this value is unique within the local computer.

IfType

A 16-bit value that specifies an Internet Assigned Numbers Authority (IANA) interface type. For example, IF_TYPE_ETHERNET_CSMACD (6) is the value for IfType that is assigned to any Ethernet-like interface. For a list of interface types, see NDIS Interface Types.

Remarks

The IfType member of the Info structure within the NET_LUID union contains an Internet Assigned Numbers Authority (IANA) defined interface type value. The NetLuidIndex member is used to distinguish between multiple interfaces that have the same interface type--this member is the part of a NET_LUID value that makes it locally unique.

The NET_LUID value is equivalent to the ifName object that is specified in RFC 2863.

To create a NET_LUID value, an NDIS interface provider uses the NDIS_MAKE_NET_LUID macro.

Requirements

Version

Supported in NDIS 6.0 and later.

Header

Ifdef.h (include Ntddndis.h)

See also

NDIS_MAKE_NET_LUID
NdisIfAllocateNetLuidIndex

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft