DVMSGID_HOSTMIGRATED

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

DVMSG_HOSTMIGRATED

The DVMSG_HOSTMIGRATED structure contains information for the DVMSGID_HOSTMIGRATED system message.

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

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, then 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.

Return Values

Return DV_OK.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dvoice.h.