DVMSGID_HOSTMIGRATED Message

Microsoft® DirectPlay® Voice generates the DVMSGID_HOSTMIGRATED message when the voice host has migrated.

The DVMSG_HOSTMIGRATED structure contains information for the DVMSGID_HOSTMIGRATED system message.

Syntax

typedef struct {
    DWORD dwSize;
    DVID dvidNewHostID;
    LPDIRECTPLAYVOICESERVER pdvServerInterface;
}  DVMSG_HOSTMIGRATED *LPDVMSG_HOSTMIGRATED, *PDVMSG_HOSTMIGRATED;

Members

dwSize

Size of the DVMSG_HOSTMIGRATED message structure.

dvidNewHostID

DVID of the new host.

pdvServerInterface

If the local client has become the new voice session host, this member will point to a newly created IDirectPlayVoiceServer object that can be used by the local client for providing host services. If the local client is not the new host, this member will be NULL. If this parameter points to an IDirectPlayVoiceServer interface, you must call IDirectPlayVoiceServer::AddRef to increment the interface's reference count. Call IDirectPlayVoiceServer::Release when you no longer need the interface.

Remarks

Return from the message callback function with DV_OK.

DirectPlay and DirectPlay Voice sessions are separate entities. While there are guarantees about message order for each interface, there are no guarantees about message order between interfaces.

Message Information

Header	dvoice.h
Minimum operating systems	Windows 98