Share via

NETWORK_ADDRESS_LIST

  • Article

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.

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

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

See Also

NdisOpenAdapter | NETWORK_ADDRESS | OID_GEN_NETWORK_LAYER_ADDRESSES

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.