diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-AC9E8926-9BC8-5D46-91CA-139C89D04F32.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/PDK/Source/GUID-AC9E8926-9BC8-5D46-91CA-139C89D04F32.dita Fri Jan 22 18:26:19 2010 +0000 @@ -0,0 +1,61 @@ + + + + + +Enabling +Graceful ShutdownEnabling graceful shutdown of a component is to determine whether +the System State Manager (SSM) has to undergo staged shutdown or existing +shutdown server mechanism must be used for device shutdown. +

Shutdown is to stop a server interface. Shutdown server handles +the shutdown of a device. It provides a notification mechanism for applications +before the shutdown occurs so that the shutdown occurs gracefully.

Follow +the procedure given below to enable or disable the graceful shutdown in either +of the following ways by using patchable constant, KSsmGracefulShutdown:

 + + +To enable support on the Emulator: + + +Add the following line to the epoc.ini file. +patchdata_ssmcmn_dll_KSsmGracefulShutdown 0xFFFFFFFF +By default, the patchable constant KSsmGracefulShutdown is +set to 0. This means that shutdown will not be graceful. + + + + +To enable support at ROM build time: + + +Configure the Base Shutdown server mechanism or the SSMA graceful shutdown +mechanism at ROM build time using a patchable constant KSsmGracefulShutdown. +The value of KSsmGracefulShutdown determines whether +the System State Manager (SSM) staged shutdown or Base Shutdown server mechanism +must be used for device shutdown. The default value for KSsmGracefulShutdown is 0x0. +If the device shutdown is to be done through SSM staged shutdown, this value +must be set to 0xFFFFFFFF. + + +To patch these values, add a line to an iby or oby file +that is included in the ROM being built using the following format: +patchdata <dll> @ <symbol> <newvalue> +patchdata ssmcmn.dll @ KSsmGracefulShutdown 0xFFFFFFFF + + + + +

The component is shutdown gracefully in either of the following +ways by using patchable constant.

+ +System State +Management Policy +Component +Shutdown Aware + \ No newline at end of file