Theater SDK Banner 

Art
[Previous][Next]

Context Lifetimes

Each context holds the value of its properties for a predetermined duration, or lifetime. The values contained in the context can be set and retrieved until the end of the lifetime of that context. The following table details the life span of the contexts.

Context Lifetime
Server Always available.
User Available from the time the client connects to the server until the time the client disconnects.
Presentation Available from the time the title is opened until the time the title is closed. A new presentation context is created for each title that is opened by each client.

Note   The pointer to the context can be lost immediately after a plug-in method returns. To maintain access to the properties during asynchronous calls, call AddRef to increment the reference counter of the interface. Alternately, the data that the component needs can be copied into temporary variables. If AddRef is used, the component must call Release to free the pointer when the context is no longer needed.

[Previous][Next]



© 1996-1998 Microsoft Corporation. All rights reserved