| 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
Header dplay8.h Minimum operating systems Windows 98, Pocket PC 2002