nn::nex::DuplicatedObject::CreateWellKnown Member Function

Syntax

static DuplicatedObject * CreateWellKnown(
     WKHandle & hWK
);

Parameters

Name Description
in hWK Specifies a global variable that indicates a reference to a well-known object instance. Must have the same name as is declared in the DDL file.

Return Values

Returns a pointer to the created well-known object.

Description

Creates the specified well-known object.

A well-known object is a duplicated object that is guaranteed to have been conveyed to all participants when a session starts. Since all stations can reference well-known objects during the session, for practical purposes they can be handled as global objects. For example, information about the game world (level, weather, opponent AI intelligence and so on) and other information that is absolutely required to start the game can be handled as well-known objects. Different games use well-known objects for different information according to their specifications.

You can use this function to create a well-known object. All well-known objects must be created before the session is created. This function must only be called by the session master.

Revision History

2011/01/27
Initial version.

CONFIDENTIAL