Compartilhar via


TDI_ADDRESS_INFO structure

The TDI_ADDRESS_INFO structure defines the structure of the information returned for a TDI_QUERY_INFORMATION request in which the IrpSp->Parameters.QueryType is set to TDI_QUERY_ADDRESS_INFO.

Syntax

typedef struct _TDI_ADDRESS_INFO {
  ULONG             ActivityCount;
  TRANSPORT_ADDRESS Address;
} TDI_ADDRESS_INFO, *PTDI_ADDRESS_INFO;

Members

  • ActivityCount
    Specifies the number of kernel-mode clients that currently have open file objects representing the given transport address.

  • Address
    Specifies a TRANSPORT_ADDRESS structure containing the transport address associated with a particular open file object.

Remarks

Each client process that calls ZwCreateFile successfully to open a particular transport address is given a handle to its own file object representing that address. Thus, a single transport address can have many associated file objects at any particular time.

Any kernel-mode client that has opened a particular transport address can make a query to determine how many other clients are currently using the same transport address. Such a client sets up an IRP with TdiBuildQueryInformation, passing in the QType TDI_QUERY_ADDRESS_INFO, and submits the IRP to the underlying transport to get this information.

TDI_ADDRESS_INFO defines the format in which the transport returns the requested information for such a query.

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

TdiBuildQueryInformation

TdiDispatchInternalDeviceControl

TDI_QUERY_INFORMATION

TRANSPORT_ADDRESS

 

 

Send comments about this topic to Microsoft