NETWORK_ADDRESS

  • Article

The NETWORK_ADDRESS structure describes the network-layer addresses that help define NETWORK_ADDRESS_LIST. The AddressCount member of NETWORK_ADDRESS_LIST contains an array of network-layer addresses, all of which are of type NETWORK_ADDRESS.

The following syntax defines the NETWORK_ADDRESS structure.

typedef struct _NETWORK_ADDRESS {
  LONG AddressCount; 
  USHORT AddressType; 
  NETWORK_ADDRESS Address[1]; 
} NETWORK_ADDRESS, *PNETWORK_ADDRESS;

Members

  • AddressCount
    Specifies the size, in bytes, of this network-layer address. The Address member contains the array of bytes that specify this address.
  • AddressType
    Specifies the protocol type that sends this object identifier and this network-layer address. This member is only valid if the AddressCount member in the NETWORK_ADDRESS_LIST structure is set to a nonzero value. The AddressCount member in NETWORK_ADDRESS_LIST is set to a nonzero value to notify a miniport or other layered driver to change the list of network-layer addresses on a bound interface. Protocol types are defined in the preceding list.
  • Address
    Array of bytes that specify this network-layer address. The AddressLength member specifies the number of bytes in this array.

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

NETWORK_ADDRESS_LIST | NdisOpenAdapter

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.