DPN_CONNECTION_INFO Structure

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

DPN_CONNECTION_INFO Structure


Used to retrieve statistics for the connection between you and a remote computer that you are connected to.

Syntax

typedef struct _DPN_CONNECTION_INFO {
    DWORD dwSize;
    DWORD dwRoundTripLatencyMS;
    DWORD dwThroughputBPS;
    DWORD dwPeakThroughputBPS;
    DWORD dwBytesSentGuaranteed;
    DWORD dwPacketsSentGuaranteed;
    DWORD dwBytesSentNonGuaranteed;
    DWORD dwPacketsSentNonGuaranteed;
    DWORD dwBytesRetried;
    DWORD dwPacketsRetried;
    DWORD dwBytesDropped;
    DWORD dwPacketsDropped;
    DWORD dwMessagesTransmittedHighPriority;
    DWORD dwMessagesTimedOutHighPriority;
    DWORD dwMessagesTransmittedNormalPriority;
    DWORD dwMessagesTimedOutNormalPriority;
    DWORD dwMessagesTransmittedLowPriority;
    DWORD dwMessagesTimedOutLowPriority;
    DWORD dwBytesReceivedGuaranteed;
    DWORD dwPacketsReceivedGuaranteed;
    DWORD dwBytesReceivedNonGuaranteed;
    DWORD dwPacketsReceivedNonGuaranteed;
    DWORD dwMessagesReceived;
} DPN_CONNECTION_INFO, *PDPN_CONNECTION_INFO;

Members

dwSize
Size of the structure.
dwRoundTripLatencyMS
Approximate time, in milliseconds (ms), it takes a packet to reach the remote computer and be returned to the local computer. This number will change throughout the session as link conditions change.
dwThroughputBPS
Approximate throughput, in bytes per second (Bps), for the link. This number will change throughout the session as link conditions change. This value is approximate, and you may want to calculate your own value for greater accuracy.
dwPeakThroughputBPS
Peak throughput, in bytes per second (Bps) for the link. This number will change throughout the session as link conditions change. This value is approximate, and you may want to calculate your own value for greater accuracy.
dwBytesSentGuaranteed
Amount, in bytes, of guaranteed messages that have been sent.
dwPacketsSentGuaranteed
Number of packets of guaranteed messages that have been sent.
dwBytesSentNonGuaranteed
Amount, in bytes, of nonguaranteed messages that have been sent.
dwPacketsSentNonGuaranteed
Number of packets of nonguaranteed messages that have been sent.
dwBytesRetried
Amount, in bytes, of messages that have been retried.
dwPacketsRetried
Amount of packets that have been retried.
dwBytesDropped
Amount, in bytes, of messages that have been dropped.
dwPacketsDropped
Number of packets that have been dropped.
dwMessagesTransmittedHighPriority
Number of high-priority messages that have been transmitted.
dwMessagesTimedOutHighPriority
Number of high-priority messages that have timed out.
dwMessagesTransmittedNormalPriority
Number of normal-priority messages that have been transmitted.
dwMessagesTimedOutNormalPriority
Number of normal-priority messages that have timed out.
dwMessagesTransmittedLowPriority
Number of low-priority messages that have been transmitted.
dwMessagesTimedOutLowPriority
Number of low priority messages that have timed out.
dwBytesReceivedGuaranteed
Amount, in bytes, of guaranteed messages that have been received.
dwPacketsReceivedGuaranteed
Number of packets of guaranteed messages that have been received.
dwBytesReceivedNonGuaranteed
Amount, in bytes, of nonguaranteed messages that have been received.
dwPacketsReceivedNonGuaranteed
Number of packets of nonguaranteed messages that have been received.
dwMessagesReceived
Number of messages that have been received.

Structure Information

Headerdplay8.h
Minimum operating systems Windows 98, Pocket PC 2002

© 2003 Microsoft Corporation. All rights reserved.