TRANSPORT_ADDRESS structure

The TRANSPORT_ADDRESS structure defines the general format for an array of TDI driver-specific transport addresses.

Syntax

typedef struct _TRANSPORT_ADDRESS {
  LONG       TAAddressCount;
  TA_ADDRESS Address[1];
} TRANSPORT_ADDRESS, *PTRANSPORT_ADDRESS;

Members

  • TAAddressCount
    Specifies the number of elements in the array at Address.

  • Address
    Specifies an array of one or more TA_ADDRESS structures each specifying a transport address of a particular TDI_ADDRESS_TYPE_XXX.

Remarks

Although any address specified in a TRANSPORT_ADDRESS structure is always driver-specific, all transports of a particular protocol type (for example, all NetBIOS transports or all IPX transports) use the same address format.

When it is given a TRANSPORT_ADDRESS structure, the transport uses the first recognizable address in the array at Address. For instance, if its client passes in several TDI_ADDRESS_TYPE_NETBIOS addresses, a NetBIOS transport would use only the first such address. If a transport can use some number of TDI_ADDRESS_TYPE_XXX addresses and it is given an array of mixed types, it uses only the first valid address of each such type.

A transport returns an error if it is given a TRANSPORT_ADDRESS structure containing elements of a type it is unable to parse. If the transport is given an address of a recognizable type that it cannot use, the transport can search the array elements for a usable address and return an error if it finds no valid address.

Note The TDI feature is deprecated and will be removed in future versions of Microsoft Windows. Depending on how you use TDI, use either the Winsock Kernel (WSK) or Windows Filtering Platform (WFP). For more information about WFP and WSK, see Windows Filtering Platform and Winsock Kernel. For a Windows Core Networking blog entry about WSK and TDI, see Introduction to Winsock Kernel (WSK).

Requirements

Header

Tdi.h (include Tdi.h or TdiKrnl.h)

See also

TA_ADDRESS

TA_APPLETALK_ADDR

TA_IP_ADDRESS

TA_IPX_ADDRESS

TA_NETBIOS_ADDRESS

TA_NS_ADDRESS

TA_VNS_ADDRESS

Send comments about this topic to Microsoft