TDI_PROVIDER_STATISTICS

TDI_PROVIDER_STATISTICS

struct _TDI_PROVIDER_STATISTICS {

ULONG Version;

ULONG OpenConnections;

ULONG ConnectionsAfterNoRetry;

ULONG ConnectionsAfterRetry;

ULONG LocalDisconnects;

ULONG RemoteDisconnects;

ULONG LinkFailures;

ULONG AdapterFailures;

ULONG SessionTimeouts;

ULONG CancelledConnections;

ULONG RemoteResourceFailures;

ULONG LocalResourceFailures;

ULONG NotFoundFailures;

ULONG NoListenFailures;

ULONG DatagramsSent;

LARGE_INTEGER DatagramBytesSent;

ULONG DatagramsReceived;

LARGE_INTEGER DatagramBytesReceived;

ULONG PacketsSent;

ULONG PacketsReceived;

ULONG DataFramesSent;

LARGE_INTEGER DataFrameBytesSent;

ULONG DataFramesReceived;

LARGE_INTEGER DataFrameBytesReceived;

ULONG DataFramesResent;

LARGE_INTEGER DataFrameBytesResent;

ULONG DataFramesRejected;

LARGE_INTEGER DataFrameBytesRejected;

ULONG ResponseTimerExpirations;

ULONG AckTimerExpirations;

ULONG MaximumSendWindow;

ULONG AverageSendWindow;

ULONG PiggybackAckQueued;

ULONG PiggybackAckTimeouts;

LARGE_INTEGER WastedPacketSpace;

ULONG WastedSpacePackets;

ULONG NumberOfResources;

TDI_PROVIDER_RESOURCE_STATS Resources[1];

} TDI_PROVIDER_STATISTICS, *PTDI_PROVIDER_STATISTICS;

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

Members

Version

Specifies the TDI version number. The low-order bytes specify the minor version number, and the high-order bytes the major version number.

OpenConnections

Specifies the number of open connection endpoints in the transport.

ConnectionsAfterNoRetry

Specifies the number of connections the transport has established with remote-node clients without doing frame retransmissions.

ConnectionsAfterRetry

Specifies the number of connections the transport has established with remote node clients after doing some frame retransmissions.

LocalDisconnects

Specifies the number of endpoint-to-endpoint connections that the transport's local-node clients have closed.

RemoteDisconnects

Specifies the number of endpoint-to-endpoint connections that remote-node clients have closed.

LinkFailures

Specifies the number of connections lost due to link-level failures.

AdapterFailures

Specifies the number of connections lost due to problems in the underlying NIC driver.

SessionTimeouts

Specifies the number of connections lost due to session-level time-outs.

CancelledConnections

Specifies the number of rejected connection offers.

RemoteResourceFailures

Specifies the number of connections that have failed due to resource problems at a remote node.

LocalResourceFailures

Specifies the number of connections that have failed due to local-node resource problems.

NotFoundFailures

Specifies the number of connection attempts that have failed because the transport could not find the specified remote node on the network.

NoListenFailures

Specifies the number of incoming connection offers failed because local-node clients were not listening for incoming connections.

DatagramsSent

Specifies the number of datagrams the TDI transport has sent.

DatagramBytesSent

Specifies the number of bytes in all datagrams the transport has sent.

DatagramsReceived

Specifies the number of datagrams the TDI transport has received.

DatagramBytesReceived

Specifies the number of bytes in all datagrams the transport has received.

PacketsSent

Specifies the number of packets, including control, data, and other frames, the transport has sent through NDIS to the physical medium.

PacketsReceived

Specifies the number of packets, including control, data, and other frames, the transport has received from the physical medium through NDIS.

DataFramesSent

Specifies the number of data frames the underlying NDIS NIC driver has sent.

DataFrameBytesSent

Specifies the number of bytes of frame data the underlying NDIS NIC driver has sent.

DataFramesReceived

Specifies the number of data frames the underlying NDIS NIC driver has received.

DataFrameBytesReceived

Specifies the number of bytes of frame data the underlying NDIS NIC driver has received.

DataFramesResent

Specifies the number of data frames the underlying NDIS NIC driver has re-sent.

DataFrameBytesResent

Specifies the number of bytes of frame data the underlying NDIS NIC driver has re-sent.

DataFramesRejected

Specifies the number of data frames the underlying NDIS NIC driver has received but rejected.

DataFrameBytesRejected

Specifies the number of bytes of frame data the underlying NDIS NIC driver has received but rejected.

ResponseTimerExpirations

Specifies the number of times the response timer (for example, T1 for NetBIOS) has expired.

AckTimerExpirations

Specifies the number of times the acknowledgment timer (for example, T2 for NetBIOS) has expired.

MaximumSendWindow

Specifies the maximum send window, in bytes, of the transport.

AverageSendWindow

Specifies the average send window, in bytes, of the transport.

PiggybackAckQueued

Specifies the number of times the transport has started a timer waiting for reverse traffic on which it can piggyback a data acknowledgment to a remote node.

PiggybackAckTimeouts

Specifies the number of times a piggyback acknowledgment timer has expired before the transport could send reverse traffic to a remote node.

WastedPacketSpace

Specifies the total number of bytes of wasted buffer space for transferred packets.

WastedSpacePackets

Specifies how many packets contributed to the value of WastedPacketSpace.

NumberOfResources

Specifies the number of elements of type TDI_PROVIDER_RESOURCE_STATS in the array at Resources.

Resources[1]

Specifies an array of TDI_PROVIDER_RESOURCE_STATS structures, each defined as follows:

struct _TDI_PROVIDER_RESOURCE_STATS {

ULONG ResourceId;

ULONG MaximumResourceUsed;

ULONG AverageResourceUsed;

ULONG ResourceExhausted;

} TDI_PROVIDER_RESOURCE_STATS, *PTDI_PROVIDER_RESOURCE_STATS;

ResourceId

Specifies a transport-specific value identifying a resource.

MaximumResourceUsed

Specifies the maximum number of resources of the specified type the transport can use concurrently.

AverageResourceUsed

Specifies the average number of resources of the specified type the transport uses overall.

ResourceExhausted

Specifies the number of times the transport has failed to allocate the specified resource.

Comments

Any kernel-mode client that has opened a control channel can make a query to determine the current statistics maintained by its underlying transport. Such a client sets up an IRP with TdiBuildQueryInformation, passing in the QType TDI_QUERY_PROVIDER_STATISTICS, and submits the IRP to the underlying transport to get this information.

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