Symbian3/PDK/Source/GUID-BBCC018A-BBD3-5609-8FCB-C9BF7EC5F627.dita
changeset 3 46218c8b8afa
parent 1 25a17d01db0c
child 5 f345bda72bc4
--- a/Symbian3/PDK/Source/GUID-BBCC018A-BBD3-5609-8FCB-C9BF7EC5F627.dita	Thu Mar 11 15:24:26 2010 +0000
+++ b/Symbian3/PDK/Source/GUID-BBCC018A-BBD3-5609-8FCB-C9BF7EC5F627.dita	Thu Mar 11 18:02:22 2010 +0000
@@ -1,46 +1,46 @@
-<?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_d0e363743_href.png" placement="inline"/>
-</fig>
+<?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_d0e363743_href.png" placement="inline"/>
+</fig>
 </conbody></concept>
\ No newline at end of file