<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-BBCC018A-BBD3-5609-8FCB-C9BF7EC5F627" xml:lang="en"><title>Dynamic
Behavior</title><shortdesc>This topic describes the dynamic behavior of the domain manager
for state transitions.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This topic describes the dynamic behavior of the domain manager for state
transitions. </p>
<p>Internally, the power state of a domain is a property that the domain manager
manages through the publish &amp; subscribe mechanism. Applications associated
with a domain subscribe to this property, in effect listening for any changes
that may be made; the domain manager publishes changes to the property. </p>
<p>Applications don't use the publish &amp; subscribe APIs directly; instead
they call <xref href="GUID-26767FE7-3AF2-3E21-9965-915855B7AB55.dita#GUID-26767FE7-3AF2-3E21-9965-915855B7AB55/GUID-3885B73A-D29A-3CE6-8A0B-1448BC5A0BFA"><apiname>RDmDomain::RequestTransitionNotification()</apiname></xref> to
request notification of changes to the domain's power state; this is, in effect,
a request to subscribe to the property. </p>
<p>When the domain manager publishes a change to the domain's power state,
applications are notified of the new value through completion of the notification
request, and can then get the new value by calling <xref href="GUID-26767FE7-3AF2-3E21-9965-915855B7AB55.dita#GUID-26767FE7-3AF2-3E21-9965-915855B7AB55/GUID-C9D18ADA-5C1B-3EF1-ABFB-A3CD4F9859B2"><apiname>RDmDomain::GetPowerState()</apiname></xref>. </p>
<p>Internally, a domain's power state property is identified by the <codeph>KUidDmPropertyCategory</codeph> UID,
and a key which is the value of the domain Id. </p>
<p>The property value itself is an integer made up of an [update number, domain
state] pair where domain state is one of the three values: <xref href="GUID-9EF60A90-6EEA-3F63-9A33-A6C1C3664C17.dita"><apiname>EPwActive</apiname></xref>, <xref href="GUID-D001F4B1-2B9F-3443-9E95-36BC3D4B2DD5.dita"><apiname>EPwStandby</apiname></xref>, <xref href="GUID-60665A9C-B9B1-3589-97A2-1FCBE8C03BBA.dita"><apiname>EPwOff</apiname></xref>,
and the update number is a 16-bit value that is incremented by 1 each time
the property is changed by the domain manager. </p>
<p>Once this property, i.e. the domain's power state, has changed, the domain
manager expects all registered applications to make appropriate changes to
their internal state, and then to acknowledge the change by calling <xref href="GUID-26767FE7-3AF2-3E21-9965-915855B7AB55.dita#GUID-26767FE7-3AF2-3E21-9965-915855B7AB55/GUID-624E1642-5EDA-35D3-BFB3-212BC4456230"><apiname>RDmDomain::AcknowledgeLastState()</apiname></xref>.
The domain manager imposes a time limit on each domain, and expects all applications
within a domain to acknowledge the change within that period. The time value
itself is part of a domain definition, and may vary between domains. Once
the time limit has been reached, the domain manager considers the power state
transition to be complete, whether or not all expected acknowledgements have
been received. Any acknowledgement received after the time limit are ignored. </p>
<fig id="GUID-712F469B-3C88-5209-8D7C-BDDF2C050A59">
<image href="GUID-52298398-A727-5EC2-80A9-4B9704366455_d0e384966_href.png" placement="inline"/>
</fig>
</conbody></concept>