DirectPlay Animated Header -- DPCAPS DirectPlay Animated Header -- DPCAPS* Microsoft DirectPlay SDK
*Index  *Topic Contents
*Previous Topic: DPACCOUNTDESC
*Next Topic: DPCHAT


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

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

*Top of Page