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

See Also

Reference

NDIS Structures
NdisOpenAdapter
NETWORK_ADDRESS
OID_GEN_NETWORK_LAYER_ADDRESSES