Symbian3/PDK/Source/GUID-264734DA-3D49-596B-A48A-B6F0D5B9143A.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-264734DA-3D49-596B-A48A-B6F0D5B9143A.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,40 @@
+<?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-264734DA-3D49-596B-A48A-B6F0D5B9143A" xml:lang="en"><title>Domain
+Management Policy Tutorial</title><shortdesc>This section describes the steps for a domain management policy
+component to use the Domain Manager. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Domain management policy code interfaces with the domain
+manager through the <xref href="GUID-C1C17273-1C4A-35D5-A564-F7FC81EDFB7B.dita"><apiname>RDmDomainManager</apiname></xref> class, which, in effect,
+controls the domain manager. Only one instance of this class can be connected
+to the domain manager at any one time. </p>
+<p>Once connected through a call to <codeph>Connect()</codeph>, domain management
+policy can trigger power state transitions for specific domains and for the
+system: </p>
+<ul>
+<li id="GUID-70196493-DD87-51E1-BFAA-E1525B9BAADF"><p>it calls <codeph>SystemShutDown()</codeph> to
+trigger a system transition to the <i>Off</i> state. The call to this function
+never returns; the device powers down, and the system must then be re-booted. </p> </li>
+<li id="GUID-DEF8B683-32AB-5207-8879-D91BC68E69CD"><p>it calls <codeph>RequestSystemTransition()</codeph> to
+trigger a system transition to the specified target power state. The target
+state can be <i>Standby</i> or <i>Off</i>. The implementation sends an asynchronous
+request to the domain manager. The request only completes when a wake-up event
+occurs triggering the system back into the <i>Active</i> state. </p> </li>
+<li id="GUID-7603C5C5-054C-54AD-814D-4FDAB6988BFF"><p>it calls <codeph>RequestDomainTransition()</codeph> to
+trigger a transition of the specified domain to the specified target power
+state. The target power state can be <i>Active</i>, <i>Standby</i> or <i>Off</i>.
+The implementation sends an asynchronous request to the domain manager. The
+request completes when the domain reaches the target state. </p> </li>
+</ul>
+</conbody><related-links>
+<link href="GUID-1197F032-1B73-58E1-8B45-E5D58B9DF788.dita"><linktext>Domain  
+              Management Policy DLL</linktext></link>
+</related-links></concept>
\ No newline at end of file