DVMSGID_LOCALHOSTSETUP

The DVMSGID_LOCALHOSTSETUP message is sent when the local client is elected to become the new voice host during host migration. The message is sent before the DVMSGID_HOSTMIGRATED message and gives you the chance to set the callback function and context value that will be used when creating the new voice server object. If you do not set either of the values, the new server interface will have no callback function. Once the application returns from handling this message, it will receive the DVMSGID_HOSTMIGRATED message. The new message has the following associated structure, which is passed in the void * field of the message handler.

DVMSG_LOCALHOSTSETUP

The DVMSG_LOCALHOSTSETUP structure contains information for the DVMSGID_LOCALHOSTSETUP system message.

typedef struct {
    DWORD dwSize;
    PVOID pvContext;
    PDVMESSAGEHANDLER pMessageHandler;
} DVMSG_LOCALHOSTSETUP, *LPDVMSG_LOCALHOSTSETUP, *PDVMSG_LOCALHOSTSETUP;

dwSize

Size of the DVMSG_LOCALHOSTSETUP message structure.

pvContext

Set this member to point to the context value for the new server.

pMessageHandler

Set this member to point to the callback message-handler function that will receive voice server messages.

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.