DPCAPS

typedef struct {

DWORD dwSize;

DWORD dwFlags;

DWORD dwMaxBufferSize;

DWORD dwMaxQueueSize;

DWORD dwMaxPlayers;

DWORD dwHundredBaud;

DWORD dwLatency;

DWORD dwMaxLocalPlayers;

DWORD dwHeaderLength;

DWORD dwTimeout;

} DPCAPS, FAR *LPDPCAPS;

Contains the capabilities of a DirectPlay object after a call to the IDirectPlay2::GetCaps or IDirectPlay2::GetPlayerCaps methods. Any of these capabilities can differ depending on whether guaranteed or nonguaranteed capabilities are requested. This structure is read-only.

dwSize

Size, in bytes, of this structure. Your application must set this member before it uses this structure; otherwise, an error will result.

dwFlags

Indicates the properties of the DirectPlay object.

DPCAPS_GROUPOPTIMIZED

Indicates that the service provider bound to this DirectPlay object can optimize group (multicast) messaging.

DPCAPS_GUARANTEEDOPTIMIZED

Indicates that the service provider bound to this DirectPlay object supports guaranteed message delivery.

DPCAPS_GUARANTEEDSUPPORTED

Indicates that the DirectPlay object supports guaranteed message delivery, either because the service provider supports it or because DirectPlay implements it on a nonguaranteed service provider.

DPCAPS_ISHOST

Indicates that the DirectPlay object created by the calling application is the session host.

DPCAPS_KEEPALIVEOPTIMIZED

The service provider can detect when the connection to the session has been lost.

dwMaxBufferSize

Maximum number of bytes that can be sent in a single packet by this service provider. Larger messages will be sent by using more than one packet.

dwMaxQueueSize

This member is no longer used.

dwMaxPlayers

Maximum number of local and remote players supported in a session by this DirectPlay object.

dwHundredBaud

Bandwidth specified in multiples of 100 bits per second. For example, a value of 24 specifies 2400 baud.

dwLatency

Estimate of latency by the service provider, in milliseconds. If this value is 0, DirectPlay cannot provide an estimate. Accuracy for some service providers rests on application-to-application testing, taking into consideration the average message size. Latency can differ depending on whether the application uses guaranteed or nonguaranteed message delivery.

dwMaxLocalPlayers

Maximum number of local players supported in a session.

dwHeaderLength

Size, in bytes, of the header that will be added to player messages by this DirectPlay object. Note that the header size depends on which service provider is in use.

dwTimeout

Service provider's suggested timeout value. By default, DirectPlay will use this timeout value when waiting for replies to messages.