DVMSGID_LOCALHOSTSETUP Message

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

DVMSGID_LOCALHOSTSETUP Message


The DVMSGID_LOCALHOSTSETUP message is sent when the local client is selected as the new voice host during host migration.

The DVMSG_LOCALHOSTSETUP structure contains information for the DVMSGID_LOCALHOSTSETUP system message.

Syntax

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

Members

dwSize
Size of the DVMSG_LOCALHOSTSETUP message structure.
pvContext
Pointer to the context value you want to set for the new server.
pMessageHandler
Pointer to the callback function to be used for the new server.

Remarks

Return from the message callback function with DV_OK.

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 host object. If you do not set either of the values, then the new server interface will have no callback function. When the application returns from handling this message, it will receive the DVMSGID_HOSTMIGRATED message.

Message Information

Headerdvoice.h
Minimum operating systems Windows 98

© 2003 Microsoft Corporation. All rights reserved.