DPN_MSGID_ENUM_HOSTS_RESPONSE Message

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

DPN_MSGID_ENUM_HOSTS_RESPONSE Message


Microsoft® DirectPlay® sends the DPN_MSGID_ENUM_HOSTS_RESPONSE message to a peer or client's message handler to convey the host's response to an enumeration request.

The DPNMSG_ENUM_HOSTS_RESPONSE structure contains information for the DPN_MSGID_ENUM_HOSTS_RESPONSE system message.

Syntax

typedef struct _DPNMSG_ENUM_HOSTS_RESPONSE {
    DWORD dwSize;
    IDirectPlay8Address *pAddressSender;
    IDirectPlay8Address *pAddressDevice;
    const DPN_APPLICATION_DESC *pApplicationDescription;
    PVOID pvResponseData;
    DWORD dwResponseDataSize;
    PVOID pvUserContext;
    DWORD dwRoundTripLatencyMS;
}  DPNMSG_ENUM_HOSTS_RESPONSE, *PDPNMSG_ENUM_HOSTS_RESPONSE;

Members

dwSize
Size of this structure.
pAddressSender
Pointer to an IDirectPlay8Address interface specifying the address of the host responding to the enumeration. You must call IDirectPlay8Address::AddRef to increment the interface's reference count. Call IDirectPlay8Address::Release when you no longer need the interface.
pAddressDevice
Pointer an IDirectPlay8Address interface specifying the address of the device. You must call IDirectPlay8Address::AddRef to increment the interface's reference count. Call IDirectPlay8Address::Release when you no longer need the interface.
pApplicationDescription
Pointer to a DPN_APPLICATION_DESC structure containing the application description.
pvResponseData
Pointer to the response data from the enumeration.
dwResponseDataSize
Size of the data pointed to in the pvResponseData member.
pvUserContext
Pointer to the user context value. This value is the same as the user context value passed to IDirectPlay8Peer::EnumHosts or IDirectPlay8Client::EnumHosts.
dwRoundTripLatencyMS
Latency measured in milliseconds.

Remarks

Return from the message callback function with DPN_OK.

Because there is no buffer to fill, this message does not generate a DPN_MSGID_RETURN_BUFFER message.

Message Information

Headerdplay8.h
Minimum operating systems Windows 98, Pocket PC 2002

© 2003 Microsoft Corporation. All rights reserved.