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
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.