##

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

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