Share via


NETWORK_ADDRESS_LIST (Windows Embedded CE 6.0)

1/6/2010

OID_GEN_NETWORK_LAYER_ADDRESSES notifies underlying miniport and other layered drivers about the list of network-layer addresses that are associated with bound instances. Miniport and other layered drivers use compatible NETWORK_ADDRESS_LIST and NETWORK_ADDRESS structures to set the list of network-layer addresses on a bound interface.

The following syntax defines a NETWORK_ADDRESS_LIST structure.

Syntax

typedef struct _NETWORK_ADDRESS_LIST {
  LONG AddressCount; 
  USHORT AddressType; 
  NETWORK_ADDRESS Address[1]; 
} NETWORK_ADDRESS_LIST, *PNETWORK_ADDRESS_LIST; 

Members

  • AddressCount
    Specifies the number of network-layer addresses listed in the array in the Address member.
  • AddressType
    Specifies the protocol type that sends this object identifier. This member is only valid if the AddressCount member is set to zero. The AddressCount member is set to zero to notify a miniport or other layered driver to clear the list of network-layer addresses on a bound interface. The following table shows the possible protocol values.

    Value Description

    NDIS_PROTOCOL_ID_DEFAULT

    Default protocol

    NDIS_PROTOCOL_ID_TCP_IP

    TCP/IP protocol

    NDIS_PROTOCOL_ID_IPX

    Netware IPX protocol

    NDIS_PROTOCOL_ID_NBF

    NetBIOS protocol

  • Address
    Array of network-layer addresses of type NETWORK_ADDRESS.

Remarks

A bound instance is the binding between the calling transport and a driver set up by a call to NdisOpenAdapter. Miniport and other layered drivers use compatible NETWORK_ADDRESS_LIST and NETWORK_ADDRESS structures to set the list of network-layer addresses on a bound interface.

A protocol can set AddressCount to a nonzero value. This notifies a miniport driver or other layered driver to change the list of network-layer addresses on a bound interface. In this case, the AddressType member in NETWORK_ADDRESS_LIST is not valid and the AddressType members in NETWORK_ADDRESS structures are valid.

If a protocol sets AddressCount to zero, the AddressType member in NETWORK_ADDRESS_LIST is valid and the AddressType members in NETWORK_ADDRESS structures are not valid.

Requirements

Header ndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Structures
NdisOpenAdapter
NETWORK_ADDRESS
OID_GEN_NETWORK_LAYER_ADDRESSES