DPCAPS

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

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;

Members

dwSize

The size of the DPCAPS structure, dwsize = sizeof(DPCAPS). 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_ENCRYPTIONSUPPORTED

Indicates that message encryption is supported by this DirectPlay object, either because it is a secure session or because the service provider can encrypt messages.

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.

DPCAPS_SIGNINGSUPPORTED

Indicates that message authentication is supported by this DirectPlay object , either because it is a secure session or because the service provider can sign messages.

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 bits per second. .

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 time-out value. By default, DirectPlay will use this time-out value when waiting for replies to messages.

See Also

IDirectPlay3::Send