Changes

Jump to navigation Jump to search

Applet Manager services (view source)

Revision as of 20:04, 26 March 2024

30,258 bytes added ,  26 March
no edit summary
Line 65: Line 65:     
== ISystemAppletProxy ==
 
== ISystemAppletProxy ==
 +
This is "nn::am::service::ISystemAppletProxy".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 95: Line 97:     
=== IHomeMenuFunctions ===
 
=== IHomeMenuFunctions ===
 +
This is "nn::am::service::IHomeMenuFunctions".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 10 || [[#RequestToGetForeground]]
 +
|-
 +
| 11 || [[#LockForeground]]
 +
|-
 +
| 12 || [[#UnlockForeground]]
 +
|-
 +
| 20 || [[#PopFromGeneralChannel]]
 +
|-
 +
| 21 || [[#GetPopFromGeneralChannelEvent]]
 +
|-
 +
| 30 || [[#GetHomeButtonWriterLockAccessor]]
 
|-
 
|-
−
| 10 || [[#RequestToGetForeground]] ||
+
| 31 || [2.0.0+] [[#GetWriterLockAccessorEx]]
 
|-
 
|-
−
| 11 || [[#LockForeground]] ||
+
| 40 || [11.0.0+] [[#IsSleepEnabled]]
 
|-
 
|-
−
| 12 || [[#UnlockForeground]] ||
+
| 41 || [12.0.0+] [[#IsRebootEnabled]]
 
|-
 
|-
−
| 20 || [[#PopFromGeneralChannel]] ||
+
| 50 || [16.0.0+] [[#LaunchSystemApplet]]
 
|-
 
|-
−
| 21 || [[#GetPopFromGeneralChannelEvent]] ||
+
| 51 || [16.0.0+] [[#LaunchStarter]]
 
|-
 
|-
−
| 30 || [[#GetHomeButtonWriterLockAccessor]] ||
+
| 100 || [6.0.0+] [[#PopRequestLaunchApplicationForDebug]]
 
|-
 
|-
−
| 31 || [2.0.0+] [[#GetWriterLockAccessorEx]] ||
+
| 110 || [9.0.0+] [[#IsForceTerminateApplicationDisabledForDebug]]
 
|-
 
|-
−
| 100 || [6.0.0+] [[#PopRequestLaunchApplicationForDebug]] ||
+
| 200 || [8.0.0+] [[#LaunchDevMenu]]
 
|-
 
|-
−
| 200 || [8.0.0+] [[#LaunchDevMenu]] ||
+
| 1000 || [11.0.0+] [[#SetLastApplicationExitReason]]
 
|}
 
|}
   Line 142: Line 158:     
The input value must be 0-3. 0 = HomeButton.
 
The input value must be 0-3. 0 = HomeButton.
 +
 +
==== IsSleepEnabled ====
 +
No input, returns an output bool.
 +
 +
==== IsRebootEnabled ====
 +
No input, returns an output bool.
 +
 +
==== LaunchSystemApplet ====
 +
No input/output.
 +
 +
This wraps [[NS_Services|ns]] LaunchSystemApplet, ignoring the u64 returned by that cmd (and other functionality).
 +
 +
==== LaunchStarter ====
 +
No input/output.
 +
 +
This is similar to [[#LaunchSystemApplet]], except this uses [[NS_Services|ns]] LaunchLibraryApplet with a ProgramId from global state.
 +
 +
The global state field is initialized elsewhere with the value of [[System_Settings|system-setting]] <code>am.debug!starter_id</code>, defaulting to ProgramId 0100000000001012 ([[Title_list|starter]]) if not available.
    
==== PopRequestLaunchApplicationForDebug ====
 
==== PopRequestLaunchApplicationForDebug ====
−
Takes a type-0x6 output buffer containing an array of u128 userIDs, returns an output u64 titleID (<code>nn::ncm::ApplicationId</code>) and an output s32 '''total_userIDs'''.
+
Takes a type-0x6 output buffer containing an array of u128 userIDs, returns an output [[NCM_services#ApplicationId|ApplicationId]] and an output s32 '''total_userIDs'''.
    
The total entries in the userID buffer must be >= {total userIDs in state}.
 
The total entries in the userID buffer must be >= {total userIDs in state}.
 +
 +
==== IsForceTerminateApplicationDisabledForDebug ====
 +
No input, returns an output u8 bool.
 +
 +
When the cached value loaded from [[Settings_services#GetDebugModeFlag]] is 0 this will just set the bool to 0. Otherwise, the bool is loaded using data from [[System_Settings|system-setting]] <code>am.debug!disable_force_terminate_application</code>.
    
==== LaunchDevMenu ====
 
==== LaunchDevMenu ====
Line 153: Line 192:  
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
 
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
   −
Uses [[NS_Services#IApplicationManagerInterface]] cmd99.
+
Uses [[NS_Services|ns]] LaunchDevMenu.
    
This is used by [[qlaunch]]. On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
 
This is used by [[qlaunch]]. On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
 +
 +
==== SetLastApplicationExitReason ====
 +
Takes an input s32, no output.
    
==== ILockAccessor ====
 
==== ILockAccessor ====
 +
This is "nn::am::service::ILockAccessor".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 167: Line 211:  
|-
 
|-
 
| 3 || [[#GetEvent]]
 
| 3 || [[#GetEvent]]
 +
|-
 +
| 4 || [10.0.0+] [[#IsLocked]]
 
|}
 
|}
   Line 181: Line 227:  
===== GetEvent =====
 
===== GetEvent =====
 
No input, returns an output Event handle with autoclear=false.
 
No input, returns an output Event handle with autoclear=false.
 +
 +
==== IsLocked ====
 +
No input, returns an output u8 bool.
    
=== IGlobalStateController ===
 
=== IGlobalStateController ===
 +
This is "nn::am::service::IGlobalStateController".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [[#RequestToEnterSleep]]
 
|-
 
|-
−
| 0 || [[#RequestToEnterSleep]] ||
+
| 1 || [[#EnterSleep]]
 
|-
 
|-
−
| 1 || [[#EnterSleep]] ||
+
| 2 || [[#StartSleepSequence]]
 
|-
 
|-
−
| 2 || [[#StartSleepSequence]] ||
+
| 3 || [[#StartShutdownSequence]]
 
|-
 
|-
−
| 3 || [[#StartShutdownSequence]] ||
+
| 4 || [[#StartRebootSequence]]
 
|-
 
|-
−
| 4 || [[#StartRebootSequence]] ||
+
| 9 || [7.0.0+] [[#IsAutoPowerDownRequested]]
 
|-
 
|-
−
| 9 || [7.0.0+] [[#IsAutoPowerDownRequested]] ||
+
| 10 || [[#LoadAndApplyIdlePolicySettings]]
 
|-
 
|-
−
| 10 || [[#LoadAndApplyIdlePolicySettings]] ||
+
| 11 || [2.0.0+] [[#NotifyCecSettingsChanged]]
 
|-
 
|-
−
| 11 || [2.0.0+] [[#NotifyCecSettingsChanged]] ||
+
| 12 || [3.0.0+] [[#SetDefaultHomeButtonLongPressTime]]
 
|-
 
|-
−
| 12 || [3.0.0+] [[#SetDefaultHomeButtonLongPressTime]] ||
+
| 13 || [3.0.0+] [[#UpdateDefaultDisplayResolution]]
 
|-
 
|-
−
| 13 || [3.0.0+] [[#UpdateDefaultDisplayResolution]] ||
+
| 14 || [3.0.0+] [[#ShouldSleepOnBoot]]
 
|-
 
|-
−
| 14 || [3.0.0+] [[#ShouldSleepOnBoot]] ||
+
| 15 || [4.0.0+] [[#GetHdcpAuthenticationFailedEvent]]
 
|-
 
|-
−
| 15 || [4.0.0+] [[#GetHdcpAuthenticationFailedEvent]] ||
+
| 30 || [12.0.0+] [[#OpenCradleFirmwareUpdater]]
 
|}
 
|}
   Line 266: Line 319:  
Uses [[#omm]] cmd GetHdcpAuthenticationFailedEvent.
 
Uses [[#omm]] cmd GetHdcpAuthenticationFailedEvent.
   −
=== IApplicationCreator ===
+
==== OpenCradleFirmwareUpdater ====
 +
No input, returns an [[#ICradleFirmwareUpdater]].
 +
 
 +
=== ICradleFirmwareUpdater ===
 +
This is "nn::am::service::ICradleFirmwareUpdater".
 +
 
 +
This was added with [12.0.0+].
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || StartUpdate
 +
|-
 +
| 1 || FinishUpdate
 +
|-
 +
| 2 || [[#GetCradleDeviceInfo]]
 +
|-
 +
| 3 || GetCradleDeviceInfoChangeEvent
 +
|-
 +
| 4 || GetUpdateProgressInfo
 +
|-
 +
| 5 || GetLastInternalResult
 +
|}
 +
 
 +
==== GetCradleDeviceInfo ====
 +
No input, returns a 8-byte CradleDeviceInfo.
 +
 
 +
[13.0.0+] Now returns a total of 0xC-bytes.
 +
 
 +
=== IApplicationCreator ===
 +
This is "nn::am::service::IApplicationCreator".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 
|-
 
|-
−
| 0 || [[#CreateApplication]] ||
+
| 0 || [[#CreateApplication]]
 
|-
 
|-
−
| 1 || [[#PopLaunchRequestedApplication]] ||
+
| 1 || [[#PopLaunchRequestedApplication]]
 
|-
 
|-
−
| 10 || [[#CreateSystemApplication]] ||
+
| 10 || [[#CreateSystemApplication]]
 
|-
 
|-
−
| 100 || [[#PopFloatingApplicationForDevelopment]] ||
+
| 100 || [[#PopFloatingApplicationForDevelopment]]
 
|}
 
|}
   Line 283: Line 368:     
==== CreateApplication ====
 
==== CreateApplication ====
−
Takes an input u64 titleID (<code>nn::ncm::ApplicationId</code>), returns an [[#IApplicationAccessor]].
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an [[#IApplicationAccessor]].
    
==== PopLaunchRequestedApplication ====
 
==== PopLaunchRequestedApplication ====
Line 289: Line 374:     
==== CreateSystemApplication ====
 
==== CreateSystemApplication ====
−
Takes an input u64 titleID (<code>nn::ncm::SystemApplicationId</code>), returns an [[#IApplicationAccessor]].
+
Takes an input [[NCM_services#ApplicationId|SystemApplicationId]], returns an [[#IApplicationAccessor]].
   −
[[qlaunch]] only uses this with a hard-coded titleID for the "starter" title.
+
[[qlaunch]] only uses this with a hard-coded id for the "starter" title.
    
==== PopFloatingApplicationForDevelopment ====
 
==== PopFloatingApplicationForDevelopment ====
Line 299: Line 384:     
==== IApplicationAccessor ====
 
==== IApplicationAccessor ====
 +
This is "nn::am::service::IApplicationAccessor".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 346: Line 433:  
|-
 
|-
 
| 170 || [8.0.0+] [[#HasSaveDataAccessPermission]] ||
 
| 170 || [8.0.0+] [[#HasSaveDataAccessPermission]] ||
 +
|-
 +
| 180 || [9.0.0+] [[#PushToFriendInvitationStorageChannel]] ||
 +
|-
 +
| 190 || [9.0.0+] [[#PushToNotificationStorageChannel]] ||
 +
|-
 +
| 200 || [10.0.0+] [[#RequestApplicationSoftReset]] ||
 +
|-
 +
| 201 || [10.0.0+] [[#RestartApplicationTimer]] ||
 
|}
 
|}
   Line 357: Line 452:     
===== GetApplicationId =====
 
===== GetApplicationId =====
−
No input, returns an output u64 titleID.
+
No input, returns an output [[NCM_services#ApplicationId|ApplicationId]].
−
 
  −
Gets the Application titleID.
      
===== PushLaunchParameter =====
 
===== PushLaunchParameter =====
Line 410: Line 503:     
===== HasSaveDataAccessPermission =====
 
===== HasSaveDataAccessPermission =====
−
Takes an input u64 titleID, returns an output u8 bool flag.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]], returns an output u8 bool flag.
   −
Gets whether the savedata specified by the input titleID is accessible. The output flag indicates whether it's accessible.
+
Gets whether the savedata specified by the input ApplicationId is accessible. The output flag indicates whether it's accessible.
   −
If the titleID matches the current application titleID, this immediately returns success with flag=1.
+
If the ApplicationId matches the current application, this immediately returns success with flag=1.
 +
 
 +
===== PushToFriendInvitationStorageChannel =====
 +
Takes an input [[#IStorage]], no output.
 +
 
 +
Clears the FriendInvitation StorageChannel, then pushes the input storage there.
 +
 
 +
===== PushToNotificationStorageChannel =====
 +
Takes an input [[#IStorage]], no output.
 +
 
 +
Clears the Notification StorageChannel, then pushes the input storage there.
 +
 
 +
[[qlaunch]] will only push data for this when launching the Application when the Alarm was triggered, where the system was previously in sleep-mode. This data is the [[Glue_services|Notification]] ApplicationParameter.
 +
 
 +
===== RequestApplicationSoftReset =====
 +
No input/output.
 +
 
 +
===== RestartApplicationTimer =====
 +
No input/output.
    
===== IAppletAccessor =====
 
===== IAppletAccessor =====
 +
This is "nn::am::service::IAppletAccessor".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 453: Line 566:     
== IAppletCommonFunctions ==
 
== IAppletCommonFunctions ==
−
Added with [[7.0.0]].
+
This is "nn::am::service::IAppletCommonFunctions".
 +
 
 +
This was added with [7.0.0+].
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [9.0.0+] [[#SetTerminateResult]]
 +
|-
 +
| 10 || [[#ReadThemeStorage]]
 +
|-
 +
| 11 || [[#WriteThemeStorage]]
 +
|-
 +
| 20 || [9.0.0+] [[#PushToAppletBoundChannel]]
 +
|-
 +
| 21 || [9.0.0+] [[#TryPopFromAppletBoundChannel]]
 +
|-
 +
| 40 || [8.0.0+] [[#GetDisplayLogicalResolution]]
 +
|-
 +
| 42 || [8.0.0+] [[#SetDisplayMagnification]]
 +
|-
 +
| 50 || [8.0.0+] [[#SetHomeButtonDoubleClickEnabled]]
 +
|-
 +
| 51 || [8.0.0+] [[#GetHomeButtonDoubleClickEnabled]]
 +
|-
 +
| 52 || [10.0.0+] [[#IsHomeButtonShortPressedBlocked]]
 +
|-
 +
| 60 || [11.0.0+] [[#IsVrModeCurtainRequired]]
 +
|-
 +
| 61 || [12.0.0+] IsSleepRequiredByHighTemperature
 +
|-
 +
| 62 || [12.0.0+] IsSleepRequiredByLowBattery
 +
|-
 +
| 70 || [11.0.0+] [[#SetCpuBoostRequestPriority]]
 +
|-
 +
| 80 || [14.0.0+] SetHandlingCaptureButtonShortPressedMessageEnabledForApplet
 +
|-
 +
| 81 || [14.0.0+] SetHandlingCaptureButtonLongPressedMessageEnabledForApplet
 +
|-
 +
| 82 || [18.0.0+]
 
|-
 
|-
−
| 10 || [[#ReadThemeStorage]] ||
+
| 90 || [15.0.0+] OpenNamedChannelAsParent
 
|-
 
|-
−
| 11 || [[#WriteThemeStorage]] ||
+
| 91 || [15.0.0+] OpenNamedChannelAsChild
 
|-
 
|-
−
| 40 || [8.0.0+] [[#GetDisplayLogicalResolution]] ||
+
| 100 || [15.0.0+] SetApplicationCoreUsageMode
 
|-
 
|-
−
| 42 || [8.0.0+] [[#SetDisplayMagnification]] ||
+
| 160 || [18.0.0+]  
 
|-
 
|-
−
| 50 || [8.0.0+] [[#SetHomeButtonDoubleClickEnabled]] ||
+
| 161 || [18.0.0+]  
 
|-
 
|-
−
| 51 || [8.0.0+] [[#GetHomeButtonDoubleClickEnabled]] ||
+
| 300 || [17.0.0+]  
 
|}
 
|}
   Line 479: Line 628:  
=== WriteThemeStorage ===
 
=== WriteThemeStorage ===
 
Takes an input u64 '''offset''' and a type-0x21 input buffer, no output.
 
Takes an input u64 '''offset''' and a type-0x21 input buffer, no output.
 +
 +
=== PushToAppletBoundChannel ===
 +
Takes an input [[#IStorage]], no output.
 +
 +
This is similar to [[#PushToAppletBoundChannelForDebug]] (no DebugMode check), except the used s32 is loaded from elsewhere and must be in the range 31-32.
 +
 +
=== TryPopFromAppletBoundChannel ===
 +
No input, returns an output [[#IStorage]].
 +
 +
This is similar to [[#TryPopFromAppletBoundChannelForDebug]] (no DebugMode check), except the used s32 is loaded from elsewhere and must be in the range 31-32.
    
=== GetDisplayLogicalResolution ===
 
=== GetDisplayLogicalResolution ===
Line 495: Line 654:  
=== GetHomeButtonDoubleClickEnabled ===
 
=== GetHomeButtonDoubleClickEnabled ===
 
No input, returns an output u8 bool.
 
No input, returns an output u8 bool.
 +
 +
=== IsHomeButtonShortPressedBlocked ===
 +
No input, returns an output u8 bool.
 +
 +
=== IsVrModeCurtainRequired ===
 +
No input, returns an output bool.
 +
 +
=== SetCpuBoostRequestPriority ===
 +
Takes an input s32, no output.
    
== ILibraryAppletProxy ==
 
== ILibraryAppletProxy ==
 +
This is "nn::am::service::ILibraryAppletProxy".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 518: Line 688:  
|-
 
|-
 
| 21 || [7.0.0+] GetAppletCommonFunctions || No input, returns an [[#IAppletCommonFunctions]].
 
| 21 || [7.0.0+] GetAppletCommonFunctions || No input, returns an [[#IAppletCommonFunctions]].
 +
|-
 +
| 22 || [15.0.0+] GetHomeMenuFunctions || No input, returns an [[#IHomeMenuFunctions]].
 +
|-
 +
| 23 || [15.0.0+] GetGlobalStateController || No input, returns an [[#IGlobalStateController]].
 
|-
 
|-
 
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
 
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
Line 523: Line 697:     
=== ILibraryAppletSelfAccessor ===
 
=== ILibraryAppletSelfAccessor ===
 +
This is "nn::am::service::ILibraryAppletSelfAccessor".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 588: Line 764:  
|-
 
|-
 
| 110 || [6.0.0+] [[#GetMainAppletAvailableUsers]] ||
 
| 110 || [6.0.0+] [[#GetMainAppletAvailableUsers]] ||
 +
|-
 +
| 120 || [9.0.0+] [[#GetLaunchStorageInfoForDebug]] ||
 +
|-
 +
| 130 || [9.0.0+] [[#GetGpuErrorDetectedSystemEvent]] ||
 +
|-
 +
| 140 || [10.0.0+] [[#SetApplicationMemoryReservation]] ||
 +
|-
 +
| 150 || [10.0.0+] [[#ShouldSetGpuTimeSliceManually]] ||
 +
|-
 +
| 160 || [17.0.0+] [[#Cmd160]] ||
 
|}
 
|}
   Line 673: Line 859:     
==== GetCurrentApplicationId ====
 
==== GetCurrentApplicationId ====
−
No input, returns an output u64.
+
No input, returns an output [[NCM_services#ApplicationId|ApplicationId]].
   −
Gets the titleID for the currently running Application. titleID=0 when no Application is running.
+
Gets the [[NCM_services#ApplicationId|ApplicationId]] for the currently running Application. ApplicationId=0 when no Application is running.
    
==== RequestExitToSelf ====
 
==== RequestExitToSelf ====
Line 683: Line 869:     
==== CreateApplicationAndPushAndRequestToLaunch ====
 
==== CreateApplicationAndPushAndRequestToLaunch ====
−
Takes an input u64 titleID and an input #IStorage, no output.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an input #IStorage, no output.
    
This is is similar to [[#CreateApplicationAndPushAndRequestToStart]].
 
This is is similar to [[#CreateApplicationAndPushAndRequestToStart]].
Line 712: Line 898:     
Normally the output bool is set to 0, however when no users are available it's set to 1 with '''total_entries''' = -1.
 
Normally the output bool is set to 0, however when no users are available it's set to 1 with '''total_entries''' = -1.
 +
 +
==== SetApplicationMemoryReservation ====
 +
Takes an input u64, no output.
 +
 +
An Application must be currently running. The input u64 must be 0x1000-byte aligned.
 +
 +
==== ShouldSetGpuTimeSliceManually ====
 +
No input, returns an output u8 bool.
 +
 +
==== Cmd160 ====
 +
No input, returns an output u64. Currently always returns 0.
    
== IOverlayAppletProxy ==
 
== IOverlayAppletProxy ==
 +
This is "nn::am::service::IOverlayAppletProxy".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 735: Line 934:  
|-
 
|-
 
| 21 || [7.0.0+] GetAppletCommonFunctions || No input, returns an [[#IAppletCommonFunctions]].
 
| 21 || [7.0.0+] GetAppletCommonFunctions || No input, returns an [[#IAppletCommonFunctions]].
 +
|-
 +
| 23 || [15.0.0+] GetGlobalStateController || No input, returns an [[#IGlobalStateController]].
 
|-
 
|-
 
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
 
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
Line 740: Line 941:     
=== IOverlayFunctions ===
 
=== IOverlayFunctions ===
 +
This is "nn::am::service::IOverlayFunctions".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 763: Line 966:  
|-
 
|-
 
| 20 || [8.0.0+] [[#SetHandlingHomeButtonShortPressedEnabled]]
 
| 20 || [8.0.0+] [[#SetHandlingHomeButtonShortPressedEnabled]]
 +
|-
 +
| 21 || [14.0.0+] SetHandlingTouchScreenInputEnabled
 +
|-
 +
| 30 || [9.0.0+] [[#SetHealthWarningShowingState]]
 +
|-
 +
| 31 || [10.0.0+] [[#IsHealthWarningRequired]]
 +
|-
 +
| 40 || [18.0.0+]
 +
|-
 +
| 41 || [18.0.0+]
 
|-
 
|-
 
| 90 || [7.0.0+] [[#SetRequiresGpuResourceUse]]
 
| 90 || [7.0.0+] [[#SetRequiresGpuResourceUse]]
Line 776: Line 989:     
==== GetApplicationIdForLogo ====
 
==== GetApplicationIdForLogo ====
−
No input, returns an output u64 titleID.
+
No input, returns an output [[NCM_services#ApplicationId|ApplicationId]].
   −
Gets the application titleID for displaying the logo screen during application launch.
+
Gets the ApplicationId for displaying the logo screen during application launch.
   −
When no application is running, this returns success with titleID=0.
+
When no application is running, this returns success with ApplicationId=0.
    
==== SetGpuTimeSliceBoost ====
 
==== SetGpuTimeSliceBoost ====
Line 806: Line 1,019:  
==== SetHandlingHomeButtonShortPressedEnabled ====
 
==== SetHandlingHomeButtonShortPressedEnabled ====
 
Takes an input u8 bool, no output.
 
Takes an input u8 bool, no output.
 +
 +
==== SetHealthWarningShowingState ====
 +
Takes an input u8 bool, no output.
 +
 +
This writes the input bool into state, signals an Event, and returns 0.
 +
 +
==== IsHealthWarningRequired ====
 +
No input, returns an output u8 bool.
    
==== SetRequiresGpuResourceUse ====
 
==== SetRequiresGpuResourceUse ====
Line 820: Line 1,041:     
== IApplicationProxy ==
 
== IApplicationProxy ==
 +
This is "nn::am::service::IApplicationProxy".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 844: Line 1,067:     
=== IApplicationFunctions ===
 
=== IApplicationFunctions ===
 +
This is "nn::am::service::IApplicationFunctions".
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 1 || [[#PopLaunchParameter]]
 +
|-
 +
| 10 || [[#CreateApplicationAndPushAndRequestToStart]]
 +
|-
 +
| 11 || [3.0.0+] [[#CreateApplicationAndPushAndRequestToStartForQuest]]
 +
|-
 +
| 12 || [4.0.0+] [[#CreateApplicationAndRequestToStart]]
 
|-
 
|-
−
| 1 || [[#PopLaunchParameter]] ||
+
| 13 || [4.0.0+] [[#CreateApplicationAndRequestToStartForQuest]]
 
|-
 
|-
−
| 10 || [[#CreateApplicationAndPushAndRequestToStart]] ||
+
| 14 || [7.0.0+] [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]]
 
|-
 
|-
−
| 11 || [3.0.0+] [[#CreateApplicationAndPushAndRequestToStartForQuest]] ||
+
| 15 || [7.0.0+] [[#CreateApplicationWithAttributeAndRequestToStartForQuest]]
 
|-
 
|-
−
| 12 || [4.0.0+] [[#CreateApplicationAndRequestToStart]] ||
+
| 20 || [[#EnsureSaveData]]
 
|-
 
|-
−
| 13 || [4.0.0+] [[#CreateApplicationAndRequestToStartForQuest]] ||
+
| 21 || [[#GetDesiredLanguage]]
 
|-
 
|-
−
| 14 || [7.0.0+] [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]] ||
+
| 22 || [[#SetTerminateResult]]
 
|-
 
|-
−
| 15 || [7.0.0+] [[#CreateApplicationWithAttributeAndRequestToStartForQuest]] ||
+
| 23 || [[#GetDisplayVersion]]
 
|-
 
|-
−
| 20 || [[#EnsureSaveData]] ||
+
| 24 || [2.0.0+] [[#GetLaunchStorageInfoForDebug]]
 
|-
 
|-
−
| 21 || [[#GetDesiredLanguage]] ||
+
| 25 || [3.0.0+] ExtendSaveData
 
|-
 
|-
−
| 22 || [[#SetTerminateResult]] ||
+
| 26 || [3.0.0+] GetSaveDataSize
 
|-
 
|-
−
| 23 || [[#GetDisplayVersion]] ||
+
| 27 || [5.0.0+] CreateCacheStorage
 
|-
 
|-
−
| 24 || [2.0.0+] [[#GetLaunchStorageInfoForDebug]] ||
+
| 28 || [11.0.0+] [[#GetSaveDataSizeMax]]
 
|-
 
|-
−
| 25 || [3.0.0+] ExtendSaveData ||
+
| 29 || [11.0.0+] [[#GetCacheStorageMax]]
 
|-
 
|-
−
| 26 || [3.0.0+] GetSaveDataSize ||
+
| 30 || [[#BeginBlockingHomeButtonShortAndLongPressed]]
 
|-
 
|-
−
| 27 || [5.0.0+] CreateCacheStorage ||
+
| 31 || [[#EndBlockingHomeButtonShortAndLongPressed]]
 
|-
 
|-
−
| 30 || [[#BeginBlockingHomeButtonShortAndLongPressed]] ||
+
| 32 || [[#BeginBlockingHomeButton]]
 
|-
 
|-
−
| 31 || [[#EndBlockingHomeButtonShortAndLongPressed]] ||
+
| 33 || [[#EndBlockingHomeButton]]
 
|-
 
|-
−
| 32 || [[#BeginBlockingHomeButton]] ||
+
| 34 || [10.0.0-15.0.1] [[#SelectApplicationLicense]]
 
|-
 
|-
−
| 33 || [[#EndBlockingHomeButton]] ||
+
| 35 || [11.0.0+] [[#GetDeviceSaveDataSizeMax]]
 
|-
 
|-
−
| 40 || [[#NotifyRunning]] ||
+
| 36 || [14.0.0+] GetLimitedApplicationLicense
 
|-
 
|-
−
| 50 || [2.0.0+] [[#GetPseudoDeviceId]] ||
+
| 37 || [14.0.0+] GetLimitedApplicationLicenseUpgradableEvent
 
|-
 
|-
−
| 60 || [2.0.0+] [[#SetMediaPlaybackStateForApplication]] ||
+
| 40 || [[#NotifyRunning]]
 
|-
 
|-
−
| 65 || [3.0.0+] [[#IsGamePlayRecordingSupported]] ||
+
| 50 || [2.0.0+] [[#GetPseudoDeviceId]]
 
|-
 
|-
−
| 66 || [3.0.0+] [[#InitializeGamePlayRecording]] ||
+
| 60 || [2.0.0+] [[#SetMediaPlaybackStateForApplication]]
 
|-
 
|-
−
| 67 || [3.0.0+] [[#SetGamePlayRecordingState]] ||
+
| 65 || [3.0.0+] [[#IsGamePlayRecordingSupported]]
 
|-
 
|-
−
| 68 || [4.0.0+] [[#RequestFlushGamePlayingMovieForDebug]] ||
+
| 66 || [3.0.0+] [[#InitializeGamePlayRecording]]
 
|-
 
|-
−
| 70 || [3.0.0+] [[#RequestToShutdown]] ||
+
| 67 || [3.0.0+] [[#SetGamePlayRecordingState]]
 
|-
 
|-
−
| 71 || [3.0.0+] [[#RequestToReboot]] ||
+
| 68 || [4.0.0+] [[#RequestFlushGamePlayingMovieForDebug]]
 
|-
 
|-
−
| 80 || [4.0.0+] [[#ExitAndRequestToShowThanksMessage]] ||
+
| 70 || [3.0.0+] [[#RequestToShutdown]]
 
|-
 
|-
−
| 90 || [4.0.0+] [[#EnableApplicationCrashReport]] ||
+
| 71 || [3.0.0+] [[#RequestToReboot]]
 
|-
 
|-
−
| 100 || [5.0.0+] [[#InitializeApplicationCopyrightFrameBuffer]] ||
+
| 72 || [10.0.0+] [[#RequestToSleep]]
 
|-
 
|-
−
| 101 || [5.0.0+] [[#SetApplicationCopyrightImage]] ||
+
| 80 || [4.0.0+] [[#ExitAndRequestToShowThanksMessage]]
 
|-
 
|-
−
| 102 || [5.0.0+] [[#SetApplicationCopyrightVisibility]] ||
+
| 90 || [4.0.0+] [[#EnableApplicationCrashReport]]
 
|-
 
|-
−
| 110 || [5.0.0+] [[#QueryApplicationPlayStatistics]] ||
+
| 100 || [5.0.0+] [[#InitializeApplicationCopyrightFrameBuffer]]  
 
|-
 
|-
−
| 111 || [6.0.0+] [[#QueryApplicationPlayStatisticsByUid]] ||
+
| 101 || [5.0.0+] [[#SetApplicationCopyrightImage]]
 
|-
 
|-
−
| 120 || [5.0.0+] [[#ExecuteProgram]] ||
+
| 102 || [5.0.0+] [[#SetApplicationCopyrightVisibility]]
 
|-
 
|-
−
| 121 || [5.0.0+] [[#ClearUserChannel]] ||
+
| 110 || [5.0.0+] [[#QueryApplicationPlayStatistics]]
 
|-
 
|-
−
| 122 || [5.0.0+] [[#UnpopToUserChannel]] ||
+
| 111 || [6.0.0+] [[#QueryApplicationPlayStatisticsByUid]]
 
|-
 
|-
−
| 123 || [5.0.0+] [[#GetPreviousProgramIndex]] ||
+
| 120 || [5.0.0+] [[#ExecuteProgram]]
 
|-
 
|-
−
| 124 || [6.0.0+] [[#EnableApplicationAllThreadDumpOnCrash]] ||
+
| 121 || [5.0.0+] [[#ClearUserChannel]]
 
|-
 
|-
−
| 130 || [8.0.0+] [[#GetGpuErrorDetectedSystemEvent]] ||
+
| 122 || [5.0.0+] [[#UnpopToUserChannel]]
 
|-
 
|-
−
| 500 || [5.0.0+] StartContinuousRecordingFlushForDebug ||
+
| 123 || [5.0.0+] [[#GetPreviousProgramIndex]]
 
|-
 
|-
−
| 1000 || [5.0.0+] [[#CreateMovieMaker]] ||
+
| 124 || [6.0.0+] [[#EnableApplicationAllThreadDumpOnCrash]]
 
|-
 
|-
−
| 1001 || [5.0.0+] [[#PrepareForJit]] ||
+
| 130 || [8.0.0+] [[#GetGpuErrorDetectedSystemEvent]]
−
|}
+
|-
−
 
+
| 131 || [11.0.0+] [[#SetDelayTimeToAbortOnGpuError]]
−
The BOTW game uses this GamePlayRecording functionality from the main-nso "nninitStartup" function, with size 0x6000000(96MiB). The official GamePlayRecording-enable code does the following(this will panic on any failure):
+
|-
 +
| 140 || [9.0.0+] [[#GetFriendInvitationStorageChannelEvent]]
 +
|-
 +
| 141 || [9.0.0+] [[#TryPopFromFriendInvitationStorageChannel]]
 +
|-
 +
| 150 || [9.0.0+] [[#GetNotificationStorageChannelEvent]]
 +
|-
 +
| 151 || [9.0.0+] [[#TryPopFromNotificationStorageChannel]]
 +
|-
 +
| 160 || [9.0.0+] [[#GetHealthWarningDisappearedSystemEvent]]
 +
|-
 +
| 170 || [9.0.0+] [[#SetHdcpAuthenticationActivated]]
 +
|-
 +
| 180 || [10.1.0+] [[#GetLaunchRequiredVersion]]
 +
|-
 +
| 181 || [10.1.0+] [[#UpgradeLaunchRequiredVersion]]
 +
|-
 +
| 190 || [11.0.0+] [[#SendServerMaintenanceOverlayNotification]]
 +
|-
 +
| 200 || [11.0.0+] [[#GetLastApplicationExitReason]]
 +
|-
 +
| 500 || [5.0.0+] [[#StartContinuousRecordingFlushForDebug]]
 +
|-
 +
| 1000 || [5.0.0+] [[#CreateMovieMaker]]
 +
|-
 +
| 1001 || [5.0.0+] [[#PrepareForJit]]
 +
|}
 +
 
 +
The BOTW game uses this GamePlayRecording functionality from the main-nso "nninitStartup" function, with size 0x6000000(96MiB). The official GamePlayRecording-enable code does the following(this will panic on any failure):
 
* [[SVC|Creates]] TransferMemory using the input buffer and size, with permissions=0.
 
* [[SVC|Creates]] TransferMemory using the input buffer and size, with permissions=0.
 
* Uses [[#InitializeGamePlayRecording]] with the TransferMemory.
 
* Uses [[#InitializeGamePlayRecording]] with the TransferMemory.
Line 950: Line 1,211:     
==== CreateApplicationAndPushAndRequestToStart ====
 
==== CreateApplicationAndPushAndRequestToStart ====
−
Takes an input u64 titleID and an input [[#IStorage]], no output. titleID=0 can be used to relaunch the current application.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an input [[#IStorage]], no output. ApplicationId=0 can be used to relaunch the current application.
    
==== CreateApplicationAndPushAndRequestToStartForQuest ====
 
==== CreateApplicationAndPushAndRequestToStartForQuest ====
−
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]), an input u64 titleID, and an input [[#IStorage]], no output.
+
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]), an input [[NCM_services#ApplicationId|ApplicationId]], and an input [[#IStorage]], no output.
    
==== CreateApplicationAndRequestToStart ====
 
==== CreateApplicationAndRequestToStart ====
−
Takes an input u64 titleID, no output.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]], no output.
    
Same as [[#CreateApplicationAndPushAndRequestToStart]] except without the input storage, official sw uses this when no input storage is specified.
 
Same as [[#CreateApplicationAndPushAndRequestToStart]] except without the input storage, official sw uses this when no input storage is specified.
    
==== CreateApplicationAndRequestToStartForQuest ====
 
==== CreateApplicationAndRequestToStartForQuest ====
−
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]) and an input u64 titleID, no output.
+
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]) and an input [[NCM_services#ApplicationId|ApplicationId]], no output.
    
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except without the input storage, official sw uses this when no input storage is specified.
 
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except without the input storage, official sw uses this when no input storage is specified.
    
==== CreateApplicationWithAttributeAndPushAndRequestToStartForQuest ====
 
==== CreateApplicationWithAttributeAndPushAndRequestToStartForQuest ====
−
Takes an input u64 titleID, a type-0x15 input buffer containing an [[#ApplicationAttribute]], an input [[#IStorage]], no output.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]], a type-0x15 input buffer containing an [[#ApplicationAttribute]], an input [[#IStorage]], no output.
    
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except the entire attributes structure is directly specified via the input buffer. This command replaces [[#CreateApplicationAndPushAndRequestToStartForQuest]], official user-processes no longer use [[#CreateApplicationAndPushAndRequestToStartForQuest]].
 
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except the entire attributes structure is directly specified via the input buffer. This command replaces [[#CreateApplicationAndPushAndRequestToStartForQuest]], official user-processes no longer use [[#CreateApplicationAndPushAndRequestToStartForQuest]].
    
==== CreateApplicationWithAttributeAndRequestToStartForQuest ====
 
==== CreateApplicationWithAttributeAndRequestToStartForQuest ====
−
Takes an input u64 titleID and a type-0x15 input buffer containing an [[#ApplicationAttribute]], no output.
+
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and a type-0x15 input buffer containing an [[#ApplicationAttribute]], no output.
    
Same as [[#CreateApplicationAndRequestToStartForQuest]] except the entire attributes structure is directly specified via the input buffer. This command replaces [[#CreateApplicationAndRequestToStartForQuest]], official user-processes no longer use [[#CreateApplicationAndPushAndRequestToStartForQuest]].
 
Same as [[#CreateApplicationAndRequestToStartForQuest]] except the entire attributes structure is directly specified via the input buffer. This command replaces [[#CreateApplicationAndRequestToStartForQuest]], official user-processes no longer use [[#CreateApplicationAndPushAndRequestToStartForQuest]].
Line 1,001: Line 1,262:     
This returns two u8s loaded from state, these are the same StorageIds from [[#ApplicationLaunchProperty]].
 
This returns two u8s loaded from state, these are the same StorageIds from [[#ApplicationLaunchProperty]].
 +
 +
==== GetSaveDataSizeMax ====
 +
No input, returns two ouput s64s.
 +
 +
==== GetCacheStorageMax ====
 +
No input, returns an output s32 and s64.
    
==== BeginBlockingHomeButtonShortAndLongPressed ====
 
==== BeginBlockingHomeButtonShortAndLongPressed ====
Line 1,019: Line 1,286:  
==== EndBlockingHomeButton ====
 
==== EndBlockingHomeButton ====
 
No input/output.
 
No input/output.
 +
 +
==== SelectApplicationLicense ====
 +
Takes an input array of [[#ApplicationLicenseType]], returns an output [[#ApplicationLicenseType]].
 +
 +
==== GetDeviceSaveDataSizeMax ====
 +
No input, returns two output s64s.
    
==== NotifyRunning ====
 
==== NotifyRunning ====
Line 1,042: Line 1,315:  
==== RequestFlushGamePlayingMovieForDebug ====
 
==== RequestFlushGamePlayingMovieForDebug ====
 
No input/output.
 
No input/output.
 +
 +
Requests to save the video recording, as if the Capture-button was held.
    
==== RequestToShutdown ====
 
==== RequestToShutdown ====
Line 1,052: Line 1,327:     
On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
 
On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
 +
 +
==== RequestToSleep ====
 +
No input/output.
    
==== ExitAndRequestToShowThanksMessage ====
 
==== ExitAndRequestToShowThanksMessage ====
Line 1,071: Line 1,349:     
User-processes create the tmem with an user-specified buffer with permissions=0. '''width''' = 1280 and '''height''' = 720.
 
User-processes create the tmem with an user-specified buffer with permissions=0. '''width''' = 1280 and '''height''' = 720.
 +
 +
After the validation checks pass the input is passed to [[OMM_services|ommdisp]] cmd500.
    
This is used as an overlay for screenshots.
 
This is used as an overlay for screenshots.
    
==== SetApplicationCopyrightImage ====
 
==== SetApplicationCopyrightImage ====
−
Takes a type-0x45 input buffer, an s32 '''x''', an s32 '''y''', an s32 '''width''', an s32 '''height''', an s32 '''WindowOriginMode''', and no output.
+
Takes a type-0x45 input buffer, an s32 '''x''', an s32 '''y''', an s32 '''width''', an s32 '''height''', an s32 [[#WindowOriginMode]], and no output.
−
 
  −
The last s32 is "nn::oe::WindowOriginMode". This should be at least 1.
      
'''x''' and '''y''' must not have the negative bit set. '''width''' and '''height''' must not be <1.
 
'''x''' and '''y''' must not have the negative bit set. '''width''' and '''height''' must not be <1.
Line 1,089: Line 1,367:     
==== QueryApplicationPlayStatistics ====
 
==== QueryApplicationPlayStatistics ====
−
Takes a type-0x6 output buffer containing an array of [[Shared_Database_services|ApplicationPlayStatistics]] and a type-0x5 input buffer containing an array of u64 titleIDs. Returns an output s32 for actual total output entries.
+
Takes a type-0x6 output buffer containing an array of [[Shared_Database_services|ApplicationPlayStatistics]] and a type-0x5 input buffer containing an array of [[NCM_services#ApplicationId|ApplicationId]]. Returns an output s32 for actual total output entries.
    
The number of entries in each array is the same.
 
The number of entries in each array is the same.
Line 1,098: Line 1,376:     
==== QueryApplicationPlayStatisticsByUid ====
 
==== QueryApplicationPlayStatisticsByUid ====
−
Takes a u128 userID, a type-0x6 output buffer containing an array of [[Shared_Database_services|ApplicationPlayStatistics]] and a type-0x5 input buffer containing an array of u64 titleIDs. Returns an output s32 for actual total output entries.
+
Takes a u128 userID, a type-0x6 output buffer containing an array of [[Shared_Database_services|ApplicationPlayStatistics]] and a type-0x5 input buffer containing an array of [[NCM_services#ApplicationId|ApplicationId]]. Returns an output s32 for actual total output entries.
    
Same as [[#QueryApplicationPlayStatistics]] except this uses [[Shared_Database_services|pdm:qry]] cmd16, to get playstats specific to userIDs.  
 
Same as [[#QueryApplicationPlayStatistics]] except this uses [[Shared_Database_services|pdm:qry]] cmd16, to get playstats specific to userIDs.  
Line 1,119: Line 1,397:  
==== GetPreviousProgramIndex ====
 
==== GetPreviousProgramIndex ====
 
No input, returns an output s32.
 
No input, returns an output s32.
 +
 +
Gets the ProgramIndex of the Application which launched this title. The output ProgramIndex is -1 when there was no previous title.
    
==== EnableApplicationAllThreadDumpOnCrash ====
 
==== EnableApplicationAllThreadDumpOnCrash ====
Line 1,126: Line 1,406:  
No input, returns an output Event handle with autoclear=false.
 
No input, returns an output Event handle with autoclear=false.
   −
This is used by sdknso during applet-application initialization. A seperate thread is setup where event-waiting is handled. When the Event is signaled, official sw will assert.
+
This is used by sdknso during applet-application initialization. A separate thread is setup where event-waiting is handled. When the Event is signaled, official sw will Abort.
   −
==== CreateMovieMaker ====
+
==== SetDelayTimeToAbortOnGpuError ====
−
Takes an input u64 and handle, returns an [[#IMovieMaker]].
+
Takes an input s64 "nn::TimeSpan", no output.
 +
 
 +
==== GetFriendInvitationStorageChannelEvent ====
 +
No input, returns an output Event handle with EventClearMode=0.
 +
 
 +
This is exposed by sdknso under <code>nn::friends::</code>. This returns a ptr to the cached Event in global state, with the Event being loaded if not previously initialized.
   −
==== PrepareForJit ====
+
==== TryPopFromFriendInvitationStorageChannel ====
−
Takes no input. Launches title 010000000000003B (currently not present on retail systems) if some context variable is not set, with that context variable being initialized afterwards.
+
No input, returns an output [[#IStorage]].
   −
=== IMovieMaker ===
+
This uses the same StorageChannel as [[#PushToFriendInvitationStorageChannel]].
−
{| class="wikitable" border="1"
  −
|-
  −
! Cmd || Name
  −
|-
  −
| 0 || [[#GetGrcMovieMaker]]
  −
|-
  −
| 1 || [[#GetLayerHandle]]
  −
|}
     −
==== GetGrcMovieMaker ====
+
This is exposed by sdknso under <code>nn::friends::</code>. When the storage_size is <0x10, this returns false. <code>data_size = storage_size-0x10;</code> Then the first 0x10-bytes from storage are read to stack, which is later copied to the output Uid on success prior to returning. Then the storage is read into the specified output buffer with storage-offset 0x10, where the size is <code>size = data_size > buf_size ? buf_size : data_size</code>. Reading is skipped if size is zero. Afterwards the used size is written to an output param. On success, true is returned.
−
No input, returns a GRC [[GRC_services|IMovieMaker]].
     −
==== GetLayerHandle ====
+
==== GetNotificationStorageChannelEvent ====
−
No input, returns an output u64.
+
No input, returns an output Event handle with EventClearMode=0.
   −
== ILibraryAppletCreator ==
+
This is exposed by sdknso under <code>nn::notification::</code>. This returns a ptr to the cached Event in global state, with the Event being loaded if not previously initialized.
−
{| class="wikitable" border="1"
  −
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 0 || [[#CreateLibraryApplet]] ||
  −
|-
  −
| 1 || [[#TerminateAllLibraryApplets]] ||
  −
|-
  −
| 2 || [[#AreAnyLibraryAppletsLeft]] ||
  −
|-
  −
| 10 || [[#CreateStorage]] ||
  −
|-
  −
| 11 || [[#CreateTransferMemoryStorage]] ||
  −
|-
  −
| 12 || [2.0.0+] [[#CreateHandleStorage]] ||
  −
|}
     −
=== CreateLibraryApplet ===
+
==== TryPopFromNotificationStorageChannel ====
−
Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], returns an [[#ILibraryAppletAccessor]].
+
No input, returns an output [[#IStorage]].
   −
=== TerminateAllLibraryApplets ===
+
This uses the same StorageChannel as [[#PushToNotificationStorageChannel]].
−
No input/output.
     −
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
+
This is exposed by sdknso under <code>nn::notification::</code>. The storage is read into the specified output buffer, where the size is <code>size = storage_size > buf_size ? buf_size : storage_size</code>. Reading is skipped if size is zero. Afterwards the used size is written to an output param.
   −
Terminates all LibraryApplets which were created by the current applet (or by the Application when used from the [[#IApplicationAccessor]] cmd).
+
==== GetHealthWarningDisappearedSystemEvent ====
 +
No input, returns an output Event with EventClearMode=0.
   −
=== AreAnyLibraryAppletsLeft ===
+
==== SetHdcpAuthenticationActivated ====
−
No input, returns an output u8 bool.
+
Takes an input u8 bool, no output.
 +
 
 +
==== GetLaunchRequiredVersion ====
 +
Takes an input [[NCM_services#ApplicationId|ApplicationId]], an u64, returns an output [[#LaunchRequiredVersion]].
 +
 
 +
sdknso passes hard-coded value 0 for the u64.
 +
 
 +
==== UpgradeLaunchRequiredVersion ====
 +
Takes an input [[#LaunchRequiredVersion]], an [[NCM_services#ApplicationId|ApplicationId]], an u64, no output.
 +
 
 +
sdknso passes hard-coded value 0 for the u64.
 +
 
 +
==== SendServerMaintenanceOverlayNotification ====
 +
Takes two input [[PCV_services#PosixTime|PosixTime]], no output.
 +
 
 +
The second input value can optionally be 0.
 +
 
 +
==== GetLastApplicationExitReason ====
 +
No input, returns an output s32.
 +
 
 +
==== StartContinuousRecordingFlushForDebug ====
 +
Takes an input s64 nanoseconds-value, returns an output Event handle with autoclear=false.
 +
 
 +
The cached value loaded from [[System_Settings|system-setting]] <code>am.debug!dev_function</code> must be set to 0x1 with size 0x1, otherwise an error is returned.
   −
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
+
==== CreateMovieMaker ====
 +
Takes an input u64 size and a TransferMemory handle, returns an [[#IMovieMaker]].
   −
Gets whether any LibraryApplets ([[#ILibraryAppletAccessor]]) which were created by the current applet are still open (or by the Application when used from the [[#IApplicationAccessor]] cmd).
+
Official sw retries using the cmd in a loop on error 0x8D4 with svcSleepThread(100000000) being used first.
   −
=== CreateStorage ===
+
Official sw uses permissions=None for the TransferMemory, with an user-specified buffer. The size of the buffer used by official sw is 0x6000000.
−
Takes an input s64 for the storage size, returns an [[#IStorage]].
     −
This allocates a buffer with the specified size which can then be accessed via [[#IStorageAccessor]].
+
==== PrepareForJit ====
 +
Takes no input. Launches the [[JIT_services|jit-sysmodule]] via [[NS_Services|ns]] LaunchLibraryApplet if it has not already been launched for the current application, storing a std::shared_ptr<> for jit-sysmodule process tracking object as an IApplicationFunctions member.
   −
=== CreateTransferMemoryStorage ===
+
~IApplicationFunctions() includes:
−
Takes an input TransferMemory copy-handle, an input u8 bool, and an s64 size, returns an [[#IStorage]].
     −
The user-process creates the TransferMemory with permissions=0.
+
    if (this->jit_process) {
 +
        Terminate(this->jit_process);
 +
        this->jit_process = nullptr;
 +
    }
   −
The TransferMemory is mapped, which can then be accessed via [[#IStorageAccessor]]. The input bool controls whether writing to the storage is allowed: [[#Write]] will throw an error if this flag is not set.
+
Thus the lifetime of the jit sysmodule is tied to the application which uses it, and each application gets its own fresh copy of the jit sysmodule.
   −
=== CreateHandleStorage ===
+
AM can also optionally launch jit-sysmodule automatically if the [[NACP]] enables it.
−
Takes an input copy-handle and an input s64, returns an [[#IStorage]]. In some cases the s64 must not have the negative bit set.
     −
The input can be arbitrary, however official sw is only (?) known to use this for TransferMemory (with s64=size).
+
=== IMovieMaker ===
 +
This is "nn::am::service::IMovieMaker".
   −
=== ILibraryAppletAccessor ===
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 
|-
 
|-
−
| 0 || [[#GetAppletStateChangedEvent]] ||
+
| 0 || [[#GetGrcMovieMaker]]
 
|-
 
|-
−
| 1 || [[#IsCompleted]] ||
+
| 1 || [[#GetLayerHandle]]
 +
|}
 +
 
 +
==== GetGrcMovieMaker ====
 +
No input, returns a GRC [[GRC_services|IMovieMaker]].
 +
 
 +
==== GetLayerHandle ====
 +
No input, returns an output u64.
 +
 
 +
== ILibraryAppletCreator ==
 +
This is "nn::am::service::ILibraryAppletCreator".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 10 || [[#Start]] ||
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 20 || [[#RequestExit]] ||
+
| 0 || [[#CreateLibraryApplet]] ||  
 
|-
 
|-
−
| 25 || [[#Terminate]] ||
+
| 1 || [[#TerminateAllLibraryApplets]] ||
 
|-
 
|-
−
| 30 || [[#GetResult]] ||
+
| 2 || [[#AreAnyLibraryAppletsLeft]] ||
 
|-
 
|-
−
| 50 || [[#SetOutOfFocusApplicationSuspendingEnabled]] ||
+
| 10 || [[#CreateStorage]] ||  
 
|-
 
|-
−
| 100 || [[#PushInData]] ||  
+
| 11 || [[#CreateTransferMemoryStorage]] ||  
 
|-
 
|-
−
| 101 || [[#PopOutData]] ||
+
| 12 || [2.0.0+] [[#CreateHandleStorage]] ||  
−
|-
+
|}
−
| 102 || [[#PushExtraStorage]] ||  
+
 
−
|-
+
=== CreateLibraryApplet ===
−
| 103 || [[#PushInteractiveInData]] ||
+
Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], returns an [[#ILibraryAppletAccessor]].
−
|-
+
 
−
| 104 || [[#PopInteractiveOutData]] ||
+
=== TerminateAllLibraryApplets ===
−
|-
+
No input/output.
−
| 105 || [[#GetPopOutDataEvent]] ||
  −
|-
  −
| 106 || [[#GetPopInteractiveOutDataEvent]] ||
  −
|-
  −
| 110 || [[#NeedsToExitProcess]] ||
  −
|-
  −
| 120 || [[#GetLibraryAppletInfo]] ||
  −
|-
  −
| 150 || [[#RequestForAppletToGetForeground]] ||
  −
|-
  −
| 160 || [2.0.0+] [[#GetIndirectLayerConsumerHandle]] ||
  −
|}
     −
Commands <=30 are inherited from [[#IAppletAccessor]]. GetLibraryAppletInfo is identical to the [[#ILibraryAppletSelfAccessor]] cmd.
+
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
   −
==== SetOutOfFocusApplicationSuspendingEnabled ====
+
Terminates all LibraryApplets which were created by the current applet (or by the Application when used from the [[#IApplicationAccessor]] cmd).
−
Takes an input u8 bool, no output.
     −
Official sw will assert prior to using this if applet-service was not initialized as *Application.
+
=== AreAnyLibraryAppletsLeft ===
 +
No input, returns an output u8 bool.
   −
==== PushInData ====
+
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
−
Takes an input [[#IStorage]], no output.
     −
==== PopOutData ====
+
Gets whether any LibraryApplets ([[#ILibraryAppletAccessor]]) which were created by the current applet are still open (or by the Application when used from the [[#IApplicationAccessor]] cmd).
−
No input, returns an output [[#IStorage]].
     −
==== PushExtraStorage ====
+
=== CreateStorage ===
−
Takes an input [[#IStorage]], no output.
+
Takes an input s64 for the storage size, returns an [[#IStorage]].
   −
==== PushInteractiveInData ====
+
This allocates a buffer with the specified size which can then be accessed via [[#IStorageAccessor]].
−
Takes an input [[#IStorage]], no output.
     −
==== PopInteractiveOutData ====
+
=== CreateTransferMemoryStorage ===
−
No input, returns an output [[#IStorage]].
+
Takes an input TransferMemory copy-handle, an input u8 bool, and an s64 size, returns an [[#IStorage]].
   −
==== GetPopOutDataEvent ====
+
The user-process creates the TransferMemory with permissions=0.
−
No input, returns an output handle with autoclear=false.
     −
==== GetPopInteractiveOutDataEvent ====
+
The TransferMemory is mapped, which can then be accessed via [[#IStorageAccessor]]. The input bool controls whether writing to the storage is allowed: [[#Write]] will throw an error if this flag is not set.
−
No input, returns an output event handle with autoclear=false.
     −
==== NeedsToExitProcess ====
+
=== CreateHandleStorage ===
−
No input, returns an output u8 bool.
+
Takes an input copy-handle and an input s64, returns an [[#IStorage]]. In some cases the s64 must not have the negative bit set.
   −
Stubbed, just returns an error.
+
The input can be arbitrary, however official sw is only (?) known to use this for TransferMemory (with s64=size).
   −
==== RequestForAppletToGetForeground ====
+
=== ILibraryAppletAccessor ===
−
No input/output.
+
This is "nn::am::service::ILibraryAppletAccessor".
   −
Stubbed, just returns an error.
  −
  −
==== GetIndirectLayerConsumerHandle ====
  −
Takes an input PID and an input u64 AppletResourceUserId, returns an output u64 IndirectLayerConsumerHandle.
  −
  −
Official sw uses this during LibraryApplet creation when [[#LibraryAppletMode]] is 0x3.
  −
  −
== ICommonStateGetter ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Cmd || Name || Notes
 
! Cmd || Name || Notes
 
|-
 
|-
−
| 0 || [[#GetEventHandle]] ||
+
| 0 || [[#GetAppletStateChangedEvent]] ||
 
|-
 
|-
−
| 1 || [[#ReceiveMessage]] ||
+
| 1 || [[#IsCompleted]] ||
 
|-
 
|-
−
| 2 || [[#GetThisAppletKind]] ||
+
| 10 || [[#Start]] ||
 
|-
 
|-
−
| 3 || [[#AllowToEnterSleep]] ||
+
| 20 || [[#RequestExit]] ||
 
|-
 
|-
−
| 4 || [[#DisallowToEnterSleep]] ||
+
| 25 || [[#Terminate]] ||
 
|-
 
|-
−
| 5 || [[#GetOperationMode]] ||
+
| 30 || [[#GetResult]] ||
 
|-
 
|-
−
| 6 || [[#GetPerformanceMode]] ||
+
| 50 || [[#SetOutOfFocusApplicationSuspendingEnabled]] ||
 
|-
 
|-
−
| 7 || [[#GetCradleStatus]] ||
+
| 60 || [10.0.0+] [[#PresetLibraryAppletGpuTimeSliceZero]] ||
 
|-
 
|-
−
| 8 || [[#GetBootMode]] ||
+
| 100 || [[#PushInData]] ||  
 
|-
 
|-
−
| 9 || [[#GetCurrentFocusState]] ||
+
| 101 || [[#PopOutData]] ||  
 
|-
 
|-
−
| 10 || [[#RequestToAcquireSleepLock]] ||
+
| 102 || [[#PushExtraStorage]] ||  
 
|-
 
|-
−
| 11 || [[#ReleaseSleepLock]] ||
+
| 103 || [[#PushInteractiveInData]] ||  
 
|-
 
|-
−
| 12 || [[#ReleaseSleepLockTransiently]] ||
+
| 104 || [[#PopInteractiveOutData]] ||  
 
|-
 
|-
−
| 13 || [[#GetAcquiredSleepLockEvent]] ||
+
| 105 || [[#GetPopOutDataEvent]] ||
 
|-
 
|-
−
| 20 || [[#PushToGeneralChannel]] ||  
+
| 106 || [[#GetPopInteractiveOutDataEvent]] ||
 
|-
 
|-
−
| 30 || [[#GetHomeButtonReaderLockAccessor]] ||  
+
| 110 || [[#NeedsToExitProcess]] ||
 
|-
 
|-
−
| 31 || [2.0.0+] [[#GetReaderLockAccessorEx]] ||  
+
| 120 || [[#GetLibraryAppletInfo]] ||  
 
|-
 
|-
−
| 32 || [7.0.0+] [[#GetWriterLockAccessorEx]] ||
+
| 150 || [[#RequestForAppletToGetForeground]] ||
 
|-
 
|-
−
| 40 || [2.0.0+] [[#GetCradleFwVersion]] ||
+
| 160 || [2.0.0+] [[#GetIndirectLayerConsumerHandle]] ||
−
|-
  −
| 50 || [3.0.0+] [[#IsVrModeEnabled]] ||
  −
|-
  −
| 51 || [3.0.0+] [[#SetVrModeEnabled]] ||
  −
|-
  −
| 52 || [4.0.0+] [[#SetLcdBacklighOffEnabled]] ||
  −
|-
  −
| 53 || [7.0.0+] [[#BeginVrModeEx]] ||
  −
|-
  −
| 54 || [7.0.0+] [[#EndVrModeEx]] ||
  −
|-
  −
| 55 || [3.0.0+] [[#IsInControllerFirmwareUpdateSection]] ||
  −
|-
  −
| 60 || [3.0.0+] [[#GetDefaultDisplayResolution]] ||
  −
|-
  −
| 61 || [3.0.0+] [[#GetDefaultDisplayResolutionChangeEvent]] ||
  −
|-
  −
| 62 || [4.0.0+] [[#GetHdcpAuthenticationState]] ||
  −
|-
  −
| 63 || [4.0.0+] [[#GetHdcpAuthenticationStateChangeEvent]] ||
  −
|-
  −
| 64 || [5.0.0+] [[#SetTvPowerStateMatchingMode]] ||
  −
|-
  −
| 65 || [5.1.0+] [[#GetApplicationIdByContentActionName]] ||
  −
|-
  −
| 66 || [6.0.0+] [[#SetCpuBoostMode]] ||
  −
|-
  −
| 80 || [6.0.0+] [[#PerformSystemButtonPressingIfInFocus]] ||
  −
|-
  −
| 90 || [7.0.0+] [[#SetPerformanceConfigurationChangedNotification]] ||
  −
|-
  −
| 91 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]] ||
  −
|-
  −
| 200 || [7.0.0+] [[#GetOperationModeSystemInfo]] ||
   
|}
 
|}
   −
Officially notification messages are handled by the application itself, not sdk-nso in ExeFS. Official apps call code in sdk-nso which basically uses svcWaitSynchronization with the event from [[#GetEventHandle]] to check whether a message is available, then if so it uses [[#ReceiveMessage]]. The actual handling for message IDs is done in the app itself(see [[#AppletMessage]]).
+
Commands <=30 are inherited from [[#IAppletAccessor]]. GetLibraryAppletInfo is identical to the [[#ILibraryAppletSelfAccessor]] cmd.
   −
[7.0.0+] User-processes now use BeginVrModeEx/EndVrModeEx instead of [[#SetVrModeEnabled]]. Prior to using using BeginVrModeEx, [[Parental_Control_services|pctl]] IsStereoVisionPermitted is used and error 0xD08E is thrown if not allowed by pctl.
+
==== SetOutOfFocusApplicationSuspendingEnabled ====
 +
Takes an input u8 bool, no output.
   −
=== GetEventHandle ===
+
Official sw will assert prior to using this if applet-service was not initialized as *Application.
−
No input. Returns an output event handle. This is signalled when a message is available with [[#ReceiveMessage]].
+
 
 +
==== PresetLibraryAppletGpuTimeSliceZero ====
 +
No input/output.
 +
 
 +
sdknso only uses with with [[Software_Keyboard|swkbd-inline]], immediately after creating the LibraryApplet.
 +
 
 +
==== PushInData ====
 +
Takes an input [[#IStorage]], no output.
 +
 
 +
==== PopOutData ====
 +
No input, returns an output [[#IStorage]].
 +
 
 +
==== PushExtraStorage ====
 +
Takes an input [[#IStorage]], no output.
 +
 
 +
==== PushInteractiveInData ====
 +
Takes an input [[#IStorage]], no output.
   −
=== ReceiveMessage ===
+
==== PopInteractiveOutData ====
−
No input. Returns an output [[#AppletMessage]]. Error 0x680 indicates no message is available.
+
No input, returns an output [[#IStorage]].
   −
=== GetThisAppletKind ===
+
==== GetPopOutDataEvent ====
−
No input, returns an output [[#AppletKind]].
+
No input, returns an output handle with autoclear=false.
   −
Stubbed, just returns an error.
+
==== GetPopInteractiveOutDataEvent ====
 +
No input, returns an output event handle with autoclear=false.
   −
=== AllowToEnterSleep ===
+
==== NeedsToExitProcess ====
−
No input/output.
+
No input, returns an output u8 bool.
    
Stubbed, just returns an error.
 
Stubbed, just returns an error.
   −
=== DisallowToEnterSleep ===
+
==== RequestForAppletToGetForeground ====
 
No input/output.
 
No input/output.
    
Stubbed, just returns an error.
 
Stubbed, just returns an error.
   −
=== GetOperationMode ===
+
==== GetIndirectLayerConsumerHandle ====
−
No input. Returns an output u8 for the current [[#OperationMode]].
+
Takes an input PID and an input u64 AppletResourceUserId, returns an output u64 IndirectLayerConsumerHandle.
   −
=== GetPerformanceMode ===
+
Official sw uses this during LibraryApplet creation when [[#LibraryAppletMode]] is 0x3.
−
No input. Returns an output u32 for the current PerformanceMode.
     −
=== GetCradleStatus ===
+
== ICommonStateGetter ==
−
No input, returns an output u8.
+
This is "nn::am::service::ICommonStateGetter".
   −
This uses [[#omm]] GetCradleStatus.
+
{| class="wikitable" border="1"
−
 
+
|-
−
=== GetBootMode ===
+
! Cmd || Name
−
No input, returns an output u8.
+
|-
−
 
+
| 0 || [[#GetEventHandle]]
−
Returns the value from [[Process_Manager_services|pm:bm]] GetBootMode.
+
|-
−
 
+
| 1 || [[#ReceiveMessage]]
−
=== GetCurrentFocusState ===
+
|-
−
No input. Returns an output u8:
+
| 2 || [[#GetThisAppletKind]]
−
 
+
|-
−
* 1: In focus.
+
| 3 || [[#AllowToEnterSleep]]
−
* 2/3: Out of focus(running in "background").
+
|-
−
 
+
| 4 || [[#DisallowToEnterSleep]]
−
=== RequestToAcquireSleepLock ===
+
|-
−
No input/output.
+
| 5 || [[#GetOperationMode]]
−
 
+
|-
−
=== ReleaseSleepLock ===
+
| 6 || [[#GetPerformanceMode]]
−
No input/output.
+
|-
−
 
+
| 7 || [[#GetCradleStatus]]
−
=== ReleaseSleepLockTransiently ===
+
|-
−
No input/output.
+
| 8 || [[#GetBootMode]]
−
 
+
|-
−
=== GetAcquiredSleepLockEvent ===
+
| 9 || [[#GetCurrentFocusState]]
−
No input, returns an output Event handle with autoclear=false.
+
|-
−
 
+
| 10 || [[#RequestToAcquireSleepLock]]
−
=== PushToGeneralChannel ===
+
|-
−
Takes an input [[#IStorage]], no output.
+
| 11 || [[#ReleaseSleepLock]]
−
 
+
|-
−
This is not usable under an Application, however it is usable under a LibraryApplet.
+
| 12 || [[#ReleaseSleepLockTransiently]]
−
 
+
|-
−
Used for sending requests to [[qlaunch]]. sdk-nso creates a 0x10-byte storage which is sent to this. The following are the functions which use this, with the data written to the storage:
+
| 13 || [[#GetAcquiredSleepLockEvent]]
−
* <code>RequestHomeMenu</code> <code>5341 4d53 0100 0000 0200 0000 0100 0000</code> Returns to the main Home Menu, equivalent to pressing the HOME button.
+
|-
−
* <code>RequestJumpToSystemUpdate</code> <code>5341 4d53 0100 0000 0b00 0000 0100 0000</code> Equivalent to entering "System Update" under System Settings. When leaving this, it returns to the main Home Menu.
+
| 14 || [11.0.0+] [[#GetWakeupCount]]
 +
|-
 +
| 20 || [[#PushToGeneralChannel]]
 +
|-
 +
| 30 || [[#GetHomeButtonReaderLockAccessor]]
 +
|-
 +
| 31 || [2.0.0+] [[#GetReaderLockAccessorEx]]
 +
|-
 +
| 32 || [7.0.0+] [[#GetWriterLockAccessorEx]]
 +
|-
 +
| 40 || [2.0.0+] [[#GetCradleFwVersion]]
 +
|-
 +
| 50 || [3.0.0+] [[#IsVrModeEnabled]]
 +
|-
 +
| 51 || [3.0.0+] [[#SetVrModeEnabled]]
 +
|-
 +
| 52 || [4.0.0+] [[#SetLcdBacklighOffEnabled]]
 +
|-
 +
| 53 || [7.0.0+] [[#BeginVrModeEx]]
 +
|-
 +
| 54 || [7.0.0+] [[#EndVrModeEx]]
 +
|-
 +
| 55 || [3.0.0+] [[#IsInControllerFirmwareUpdateSection]]
 +
|-
 +
| 59 || [11.0.0+] [[#SetVrPositionForDebug]]
 +
|-
 +
| 60 || [3.0.0+] [[#GetDefaultDisplayResolution]]
 +
|-
 +
| 61 || [3.0.0+] [[#GetDefaultDisplayResolutionChangeEvent]]
 +
|-
 +
| 62 || [4.0.0+] [[#GetHdcpAuthenticationState]]
 +
|-
 +
| 63 || [4.0.0+] [[#GetHdcpAuthenticationStateChangeEvent]]
 +
|-
 +
| 64 || [5.0.0+] [[#SetTvPowerStateMatchingMode]]
 +
|-
 +
| 65 || [5.1.0+] [[#GetApplicationIdByContentActionName]]
 +
|-
 +
| 66 || [6.0.0+] [[#SetCpuBoostMode]]
 +
|-
 +
| 67 || [10.0.0+] [[#CancelCpuBoostMode]]
 +
|-
 +
| 68 || [11.0.0+] [[#GetBuiltInDisplayType]]
 +
|-
 +
| 80 || [6.0.0+] [[#PerformSystemButtonPressingIfInFocus]]
 +
|-
 +
| 90 || [7.0.0+] [[#SetPerformanceConfigurationChangedNotification]]
 +
|-
 +
| 91 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
 +
|-
 +
| 100 || [9.1.0+] [[#SetHandlingHomeButtonShortPressedEnabled]]
 +
|-
 +
| 110 || [11.0.0+] [[#OpenMyGpuErrorHandler]]
 +
|-
 +
| 120 || [13.0.0+] GetAppletLaunchedHistory
 +
|-
 +
| 200 || [7.0.0+] [[#GetOperationModeSystemInfo]]
 +
|-
 +
| 300 || [9.0.0+] [[#GetSettingsPlatformRegion]]
 +
|-
 +
| 400 || [10.0.0+] [[#ActivateMigrationService]]
 +
|-
 +
| 401 || [10.0.0+] [[#DeactivateMigrationService]]
 +
|-
 +
| 500 || [11.0.0+] [[#DisableSleepTillShutdown]]
 +
|-
 +
| 501 || [11.0.0+] [[#SuppressDisablingSleepTemporarily]]
 +
|-
 +
| 502 || [12.0.0+] IsSleepEnabled
 +
|-
 +
| 503 || [12.0.0+] IsDisablingSleepSuppressed
 +
|-
 +
| 600 || [17.0.0+] OpenNamedChannelAsChild
 +
|-
 +
| 900 || [11.0.0+] [[#SetRequestExitToLibraryAppletAtExecuteNextProgramEnabled]]
 +
|-
 +
| 910 || [17.0.0+] GetLaunchRequiredTick
 +
|}
   −
=== GetHomeButtonReaderLockAccessor ===
+
Officially notification messages are handled by the application itself, not sdk-nso in ExeFS. Official apps call code in sdk-nso which basically uses svcWaitSynchronization with the event from [[#GetEventHandle]] to check whether a message is available, then if so it uses [[#ReceiveMessage]]. The actual handling for message IDs is done in the app itself(see [[#AppletMessage]]).
−
No input, returns an output [[#ILockAccessor]].
     −
Similar to using [[#GetReaderLockAccessorEx]] with inval=0.
+
[7.0.0+] User-processes now use BeginVrModeEx/EndVrModeEx instead of [[#SetVrModeEnabled]]. Prior to using using BeginVrModeEx, [[Parental_Control_services|pctl]] IsStereoVisionPermitted is used and error 0xD08E is thrown if not allowed by pctl.
   −
=== GetReaderLockAccessorEx ===
+
=== GetEventHandle ===
−
Takes an input u32, returns an output [[#ILockAccessor]].
+
No input. Returns an output event handle. This is signalled when a message is available with [[#ReceiveMessage]].
   −
The input value must be 0-3. 0 = HomeButton.
+
=== ReceiveMessage ===
 +
No input. Returns an output [[#AppletMessage]]. Error 0x680 indicates no message is available.
   −
=== GetWriterLockAccessorEx ===
+
=== GetThisAppletKind ===
−
Takes an input u32, returns an output [[#ILockAccessor]].
+
No input, returns an output [[#AppletKind]].
   −
The input value must be 0-3. 0 = HomeButton.
+
Stubbed, just returns an error.
   −
=== GetCradleFwVersion ===
+
=== AllowToEnterSleep ===
−
No input, returns 4 output u32s.
+
No input/output.
   −
This uses [[#omm]] GetCradleFwVersion.
+
Stubbed, just returns an error.
   −
=== IsVrModeEnabled ===
+
=== DisallowToEnterSleep ===
−
No input, returns an output u8 bool.
+
No input/output.
   −
=== SetVrModeEnabled ===
+
Stubbed, just returns an error.
−
Takes an input u8 bool flag. No output.
     −
Updates internal AM state fields. If the new state doesn't match the previous state, this uses the [[Backlight_services]] {Disable/Enable}VrMode command depending on whether flag={disable/enable}.
+
=== GetOperationMode ===
 +
No input. Returns an output u8 for the current [[#OperationMode]].
   −
When the VrMode is set to true, the console shows a screen rendered like vr asking the user to move his face away and hit the 'close' button. When this button is pressed, the console resets the vrMode to false.
+
=== GetPerformanceMode ===
 +
No input. Returns an output u32 for the current [[#PerformanceMode]].
   −
=== SetLcdBacklighOffEnabled ===
+
=== GetCradleStatus ===
−
Takes an input u8 bool, no output.
+
No input, returns an output u8.
   −
Sets whether the LCD screen blacklight is turned off.
+
This uses [[#omm]] GetCradleStatus.
   −
=== BeginVrModeEx ===
+
=== GetBootMode ===
 +
No input, returns an output u8.
 +
 
 +
Returns the value from [[Process_Manager_services|pm:bm]] GetBootMode.
 +
 
 +
=== GetCurrentFocusState ===
 +
No input. Returns an output u8 [[#FocusState]].
 +
 
 +
=== RequestToAcquireSleepLock ===
 
No input/output.
 
No input/output.
   −
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=1.
+
=== ReleaseSleepLock ===
 +
No input/output.
   −
=== EndVrModeEx ===
+
=== ReleaseSleepLockTransiently ===
 
No input/output.
 
No input/output.
   −
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=0.
+
=== GetAcquiredSleepLockEvent ===
 +
No input, returns an output Event handle with autoclear=false.
   −
=== IsInControllerFirmwareUpdateSection ===
+
=== GetWakeupCount ===
−
No input, returns an output u8 bool.
+
No input, returns an output u64.
   −
=== GetDefaultDisplayResolution ===
+
=== PushToGeneralChannel ===
−
No input, returns two output s32s '''width''' and '''height'''.
+
Takes an input [[#IStorage]], no output.
   −
=== GetDefaultDisplayResolutionChangeEvent ===
+
This is not usable under an Application, however it is usable under a LibraryApplet.
−
No input, returns an output Event handle with autoclear=true.
     −
=== GetHdcpAuthenticationState ===
+
Used for sending requests to [[qlaunch]]. sdk-nso creates a 0x10-byte storage which is sent to this. The following are the functions which use this, with the data written to the storage:
−
No input, returns an output s32.
+
* <code>RequestHomeMenu</code> <code>5341 4d53 0100 0000 0200 0000 0100 0000</code> Returns to the main Home Menu, equivalent to pressing the HOME button.
 +
* <code>RequestJumpToSystemUpdate</code> <code>5341 4d53 0100 0000 0b00 0000 0100 0000</code> Equivalent to entering "System Update" under System Settings. When leaving this, it returns to the main Home Menu.
   −
=== GetHdcpAuthenticationStateChangeEvent ===
+
=== GetHomeButtonReaderLockAccessor ===
−
No input, returns an output Event handle with autoclear=true.
+
No input, returns an output [[#ILockAccessor]].
   −
=== SetTvPowerStateMatchingMode ===
+
Similar to using [[#GetReaderLockAccessorEx]] with inval=0.
−
Takes an input s32 [[#TvPowerStateMatchingMode]], no output.
     −
=== GetApplicationIdByContentActionName ===
+
=== GetReaderLockAccessorEx ===
−
Takes a type-0x5 input buffer containing a string, returns an output u64 titleID.
+
Takes an input u32, returns an output [[#ILockAccessor]].
 +
 
 +
The input value must be 0-3. 0 = HomeButton.
 +
 
 +
=== GetWriterLockAccessorEx ===
 +
Takes an input u32, returns an output [[#ILockAccessor]].
   −
Gets the application titleID for the specified ContentActionName string. Returns an error when the current [[#AppletId]] isn't 0x04 (when the current applet isn't a SystemApplication).
+
The input value must be 0-3. 0 = HomeButton.
   −
=== SetCpuBoostMode ===
+
=== GetCradleFwVersion ===
−
Takes an input u32 '''CpuBoostMode''' (only modes 0 and 1 are valid) and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].
+
No input, returns 4 output u32s.
   −
=== PerformSystemButtonPressingIfInFocus ===
+
This uses [[#omm]] GetCradleFwVersion.
−
Takes an input [[#SystemButtonType]], no output.
     −
Just returns 0 when a state field is not value 1. Verifies that the input button is allowed, then calls the same func as [[#PerformSystemButtonPressing]] internally.
+
=== IsVrModeEnabled ===
 +
No input, returns an output u8 bool.
   −
=== SetPerformanceConfigurationChangedNotification ===
+
=== SetVrModeEnabled ===
−
Takes an input u8 bool, no output.
+
Takes an input u8 bool flag. No output.
   −
=== GetCurrentPerformanceConfiguration ===
+
Updates internal AM state fields. If the new state doesn't match the previous state, this uses the [[Backlight_services]] {Disable/Enable}VrMode command depending on whether flag={disable/enable}.
−
No input, returns the result of calling [[PPC_services#apm:sys|GetCurrentPerformanceConfiguration]].
     −
=== GetOperationModeSystemInfo ===
+
When the VrMode is set to true, the console shows a screen rendered like vr asking the user to move his face away and hit the 'close' button. When this button is pressed, the console resets the vrMode to false.
−
No input, returns an output u32.
     −
This returns the output from omm [[#Cmd26]].
+
=== SetLcdBacklighOffEnabled ===
 +
Takes an input u8 bool, no output.
   −
== ISelfController ==
+
Sets whether the LCD screen blacklight is turned off.
−
{| class="wikitable" border="1"
+
 
−
|-
+
=== BeginVrModeEx ===
−
! Cmd || Name
+
No input/output.
−
|-
+
 
−
| 0 || [[#Exit]]
+
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=1.
−
|-
+
 
−
| 1 || [[#LockExit]]
+
=== EndVrModeEx ===
−
|-
+
No input/output.
−
| 2 || [[#UnlockExit]]
+
 
−
|-
+
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=0.
−
| 3 || [2.0.0+] [[#EnterFatalSection]]
+
 
−
|-
+
=== IsInControllerFirmwareUpdateSection ===
−
| 4 || [2.0.0+] [[#LeaveFatalSection]]
+
No input, returns an output u8 bool.
−
|-
+
 
−
| 9 || [[#GetLibraryAppletLaunchableEvent]]
+
=== SetVrPositionForDebug ===
−
|-
+
Takes 4 input s32s, no output.
−
| 10 || [[#SetScreenShotPermission]]
+
 
−
|-
+
The s32s are: x, y, width, height.
−
| 11 || [[#SetOperationModeChangedNotification]]
+
 
−
|-
+
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
−
| 12 || [[#SetPerformanceModeChangedNotification]]
+
 
−
|-
+
width must be 1-1280, height must be 1-720.
−
| 13 || [[#SetFocusHandlingMode]]
+
 
−
|-
+
x and y must not be negative. x+width must be <=1280. y+height must be <=720.
−
| 14 || [[#SetRestartMessageEnabled]]
+
 
−
|-
+
=== GetDefaultDisplayResolution ===
−
| 15 || [2.0.0+] [[#SetScreenShotAppletIdentityInfo]]
+
No input, returns two output s32s '''width''' and '''height'''.
−
|-
+
 
−
| 16 || [2.0.0+] [[#SetOutOfFocusSuspendingEnabled]]
+
=== GetDefaultDisplayResolutionChangeEvent ===
−
|-
+
No input, returns an output Event handle with autoclear=true.
−
| 17 || [3.0.0+] [[#SetControllerFirmwareUpdateSection]]
+
 
−
|-
+
=== GetHdcpAuthenticationState ===
−
| 18 || [3.0.0+] [[#SetRequiresCaptureButtonShortPressedMessage]]
+
No input, returns an output s32.
−
|-
+
 
−
| 19 || [3.0.0+] [[#SetAlbumImageOrientation]]
+
=== GetHdcpAuthenticationStateChangeEvent ===
−
|-
+
No input, returns an output Event handle with autoclear=true.
−
| 20 || [4.0.0+] [[#SetDesirableKeyboardLayout]]
+
 
−
|-
+
=== SetTvPowerStateMatchingMode ===
−
| 40 || [[#CreateManagedDisplayLayer]]
+
Takes an input s32 [[#TvPowerStateMatchingMode]], no output.
−
|-
+
 
−
| 41 || [4.0.0+] [[#IsSystemBufferSharingEnabled]]
+
=== GetApplicationIdByContentActionName ===
−
|-
+
Takes a type-0x5 input buffer containing a string, returns an output [[NCM_services#ApplicationId|ApplicationId]].
−
| 42 || [4.0.0+] [[#GetSystemSharedLayerHandle]]
+
 
−
|-
+
Gets the ApplicationId for the specified ContentActionName string. Returns an error when the current [[#AppletId]] isn't 0x04 (when the current applet isn't a SystemApplication).
−
| 43 || [5.0.0+] [[#GetSystemSharedBufferHandle]]
+
 
−
|-
+
=== SetCpuBoostMode ===
−
| 50 || [[#SetHandlesRequestToDisplay]]
+
Takes an input u32 [[#CpuBoostMode]] and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].
−
|-
+
 
−
| 51 || [[#ApproveToDisplay]]
+
=== CancelCpuBoostMode ===
−
|-
+
No input/output.
−
| 60 || [[#OverrideAutoSleepTimeAndDimmingTime]]
+
 
−
|-
+
=== GetBuiltInDisplayType ===
−
| 61 || [[#SetMediaPlaybackState]]
+
No input, returns an output s32.
−
|-
+
 
−
| 62 || [[#SetIdleTimeDetectionExtension]]
+
This is not exposed by sdknso.
 +
 
 +
This loads a s32 index from global state (originates from [[SPL_services#GetConfig|GetConfig]] [[SMC#HardwareType|HardwareType]]), Aborts if it's out-of-bounds, then the following is returned for the output s32: global_array[loaded_index].
 +
 
 +
=== PerformSystemButtonPressingIfInFocus ===
 +
Takes an input [[#SystemButtonType]], no output.
 +
 
 +
Just returns 0 when a state field is not value 1. Verifies that the input button is allowed, then calls the same func as [[#PerformSystemButtonPressing]] internally.
 +
 
 +
=== SetPerformanceConfigurationChangedNotification ===
 +
Takes an input u8 bool, no output.
 +
 
 +
=== GetCurrentPerformanceConfiguration ===
 +
No input, returns the result of calling [[PPC_services#apm:sys|GetCurrentPerformanceConfiguration]].
 +
 
 +
=== OpenMyGpuErrorHandler ===
 +
No input, returns an [[#IGpuErrorHandler]].
 +
 
 +
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
 +
 
 +
=== GetOperationModeSystemInfo ===
 +
No input, returns an output u32.
 +
 
 +
This returns the output from [[#GetOperationModeSystemInfo_2|omm GetOperationModeSystemInfo]].
 +
 
 +
=== GetSettingsPlatformRegion ===
 +
No input, returns an output u8.
 +
 
 +
This just returns the output from [[Settings_services#GetPlatformRegion|setsys GetPlatformRegion]].
 +
 
 +
=== ActivateMigrationService ===
 +
No input/output.
 +
 
 +
Besides various other functionality, if required this eventually uses [[NS_Services|ns]] LaunchLibraryApplet to launch [[Migration_services|migration]].
 +
 
 +
=== DeactivateMigrationService ===
 +
No input/output.
 +
 
 +
=== DisableSleepTillShutdown ===
 +
No input/output.
 +
 
 +
=== SuppressDisablingSleepTemporarily ===
 +
Takes an input u64 "nn::TimeSpanType", no output.
 +
 
 +
=== SetRequestExitToLibraryAppletAtExecuteNextProgramEnabled ===
 +
No input/output.
 +
 
 +
=== IGpuErrorHandler ===
 +
This is "nn::am::service::IGpuErrorHandler".
 +
 
 +
This was added with [11.0.0+].
 +
 
 +
This uses various [[NV_services#nvgem:cd|nvgem:cd]] commands.
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 63 || [[#GetIdleTimeDetectionExtension]]
+
! Cmd || Name
 
|-
 
|-
−
| 64 || [[#SetInputDetectionSourceSet]]
+
| 100 || [[#GetManualGpuErrorInfoSize]]
 
|-
 
|-
−
| 65 || [2.0.0+] [[#ReportUserIsActive]]
+
| 101 || [[#GetManualGpuErrorInfo]]
 
|-
 
|-
−
| 66 || [3.0.0+] [[#GetCurrentIlluminance]]
+
| 102 || [[#GetManualGpuErrorDetectionSystemEvent]]
 
|-
 
|-
−
| 67 || [3.0.0+] [[#IsIlluminanceAvailable]]
+
| 103 || [[#FinishManualGpuErrorHandling]]
 +
|}
 +
 
 +
==== GetManualGpuErrorInfoSize ====
 +
No input, returns an output u64.
 +
 
 +
==== GetManualGpuErrorInfo ====
 +
Takes a type-0x6 output buffer, returns an output u64.
 +
 
 +
The OutBuffer_size must be >= the output size from [[#GetManualGpuErrorInfoSize]].
 +
 
 +
sdknso exposes the buffer as <code>void*</code>.
 +
 
 +
==== GetManualGpuErrorDetectionSystemEvent ====
 +
No input, returns an output Event handle with EventClearMode=0.
 +
 
 +
==== FinishManualGpuErrorHandling ====
 +
No input/output.
 +
 
 +
== ISelfController ==
 +
This is "nn::am::service::ISelfController".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 
|-
 
|-
−
| 68 || [5.0.0+] [[#SetAutoSleepDisabled]]
+
| 0 || [[#Exit]]
 
|-
 
|-
−
| 69 || [5.0.0+] [[#IsAutoSleepDisabled]]
+
| 1 || [[#LockExit]]
 
|-
 
|-
−
| 70 || [4.0.0+] [[#ReportMultimediaError]]
+
| 2 || [[#UnlockExit]]
 
|-
 
|-
−
| 71 || [5.0.0+] [[#GetCurrentIlluminanceEx]]
+
| 3 || [2.0.0+] [[#EnterFatalSection]]
 
|-
 
|-
−
| 80 || [4.0.0+] [[#SetWirelessPriorityMode]]
+
| 4 || [2.0.0+] [[#LeaveFatalSection]]
 
|-
 
|-
−
| 90 || [6.0.0+] [[#GetAccumulatedSuspendedTickValue]]
+
| 9 || [[#GetLibraryAppletLaunchableEvent]]
 
|-
 
|-
−
| 91 || [6.0.0+] [[#GetAccumulatedSuspendedTickChangedEvent]]
+
| 10 || [[#SetScreenShotPermission]]
 
|-
 
|-
−
| 100 || [7.0.0+] [[#SetAlbumImageTakenNotificationEnabled]]
+
| 11 || [[#SetOperationModeChangedNotification]]
 
|-
 
|-
−
| 110 || [8.0.0+] [[#SetApplicationAlbumUserData]]
+
| 12 || [[#SetPerformanceModeChangedNotification]]
 
|-
 
|-
−
| 1000 || [7.0.0+] [[#GetDebugStorageChannel]]
+
| 13 || [[#SetFocusHandlingMode]]
−
|}
  −
 
  −
=== Exit ===
  −
No input/output.
  −
 
  −
Exits the current applet. On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
  −
 
  −
=== LockExit ===
  −
No input/output.
  −
 
  −
Locks exit process of pressing X to close in HOME Menu for an application or HOME button for an applet. When locked, it will show the "waiting for software to be closed dialog" until UnlockExit is called or a 15 seconds timeout (when the latter occurs, the process is force-terminated).
  −
 
  −
=== UnlockExit ===
  −
No input/output.
  −
 
  −
Unlocks exit process, if LockExit was previously used.
  −
 
  −
=== EnterFatalSection ===
  −
No input/output.
  −
 
  −
=== LeaveFatalSection ===
  −
No input/output.
  −
 
  −
[[#EnterFatalSection]] must be executed at least once before executing this command, otherwise error code 0x40080 will be returned. EnterFatalSection and LeaveFatalSection work in pairs, that is, N calls to EnterFatalSection must be performed first in order to perform N executions of LeaveFatalSection. Essentially, these two functions operate like how one would lock and unlock a recursive mutex.
  −
 
  −
=== GetLibraryAppletLaunchableEvent ===
  −
No input, returns an output event handle with autoclear=false.
  −
 
  −
=== SetScreenShotPermission ===
  −
Takes an input s32. No output.
  −
 
  −
Controls whether screenshot-capture is allowed.
  −
 
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Value || Description
+
| 14 || [[#SetRestartMessageEnabled]]
 +
|-
 +
| 15 || [2.0.0+] [[#SetScreenShotAppletIdentityInfo]]
 +
|-
 +
| 16 || [2.0.0+] [[#SetOutOfFocusSuspendingEnabled]]
 +
|-
 +
| 17 || [3.0.0+] [[#SetControllerFirmwareUpdateSection]]
 +
|-
 +
| 18 || [3.0.0+] [[#SetRequiresCaptureButtonShortPressedMessage]]
 +
|-
 +
| 19 || [3.0.0+] [[#SetAlbumImageOrientation]]
 +
|-
 +
| 20 || [4.0.0+] [[#SetDesirableKeyboardLayout]]
 +
|-
 +
| 21 || [13.0.0+] GetScreenShotProgramId
 
|-
 
|-
−
| 0 || Inherit from parent applet
+
| 40 || [[#CreateManagedDisplayLayer]]
 
|-
 
|-
−
| 1 || Enable
+
| 41 || [4.0.0+] [[#IsSystemBufferSharingEnabled]]
 
|-
 
|-
−
| 2 || Disable
+
| 42 || [4.0.0+] [[#GetSystemSharedLayerHandle]]
 
|-
 
|-
−
|}
+
| 43 || [5.0.0+] [[#GetSystemSharedBufferHandle]]
−
 
+
|-
−
=== SetOperationModeChangedNotification ===
+
| 44 || [10.0.0+] [[#CreateManagedDisplaySeparableLayer]]
−
Takes an input u8 bool flag. No output.
+
|-
−
 
+
| 45 || [10.0.0+] [[#SetManagedDisplayLayerSeparationMode]]
−
=== SetPerformanceModeChangedNotification ===
+
|-
−
Takes an input u8 bool flag. No output.
+
| 46 || [13.0.0+] [[#SetRecordingLayerCompositionEnabled]]
−
 
+
|-
−
=== SetFocusHandlingMode ===
+
| 50 || [[#SetHandlesRequestToDisplay]]
−
Takes 3 input u8s with each field located immediately after the previous u8, these are bool flags. No output.
+
|-
−
 
+
| 51 || [[#ApproveToDisplay]]
−
=== SetRestartMessageEnabled ===
+
|-
−
Takes an input u8 bool flag, no output.
+
| 60 || [[#OverrideAutoSleepTimeAndDimmingTime]]
−
 
+
|-
−
See [[#AppletMessage]].
+
| 61 || [[#SetMediaPlaybackState]]
−
 
+
|-
−
=== SetScreenShotAppletIdentityInfo ===
+
| 62 || [[#SetIdleTimeDetectionExtension]]
−
Takes an input [[#AppletIdentityInfo]], no output.
+
|-
−
 
+
| 63 || [[#GetIdleTimeDetectionExtension]]
−
=== SetOutOfFocusSuspendingEnabled ===
+
|-
−
Takes an input u8 bool flag. No output.
+
| 64 || [[#SetInputDetectionSourceSet]]
−
 
+
|-
−
=== SetControllerFirmwareUpdateSection ===
+
| 65 || [2.0.0+] [[#ReportUserIsActive]]
−
Takes an input u8 bool flag, no output.
+
|-
−
 
+
| 66 || [3.0.0+] [[#GetCurrentIlluminance]]
−
This throws error 0x40280 when the internal state flag already matches the input value.
+
|-
−
 
+
| 67 || [3.0.0+] [[#IsIlluminanceAvailable]]
−
=== SetRequiresCaptureButtonShortPressedMessage ===
+
|-
−
Takes an input u8 bool flag, no output.
+
| 68 || [5.0.0+] [[#SetAutoSleepDisabled]]
−
 
+
|-
−
See [[#AppletMessage]].
+
| 69 || [5.0.0+] [[#IsAutoSleepDisabled]]
 +
|-
 +
| 70 || [4.0.0+] [[#ReportMultimediaError]]
 +
|-
 +
| 71 || [5.0.0+] [[#GetCurrentIlluminanceEx]]
 +
|-
 +
| 72 || [9.0.0+] [[#SetInputDetectionPolicy]]
 +
|-
 +
| 80 || [4.0.0+] [[#SetWirelessPriorityMode]]
 +
|-
 +
| 90 || [6.0.0+] [[#GetAccumulatedSuspendedTickValue]]
 +
|-
 +
| 91 || [6.0.0+] [[#GetAccumulatedSuspendedTickChangedEvent]]
 +
|-
 +
| 100 || [7.0.0+] [[#SetAlbumImageTakenNotificationEnabled]]
 +
|-
 +
| 110 || [8.0.0+] [[#SetApplicationAlbumUserData]]
 +
|-
 +
| 120 || [11.0.0+] [[#SaveCurrentScreenshot]]
 +
|-
 +
| 130 || [13.0.0+] [[#SetRecordVolumeMuted]]
 +
|-
 +
| 1000 || [7.0.0+] [[#GetDebugStorageChannel]]
 +
|}
   −
When enabled with a non-Overlay applet, Overlay applet will not be notified of capture button short-presses for screenshots.
+
=== Exit ===
 +
No input/output.
   −
=== SetAlbumImageOrientation ===
+
Exits the current applet. On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
−
Takes an input u32 "nn::album::ImageOrientation". No output.
     −
The input value must not be >3.
+
=== LockExit ===
 +
No input/output.
   −
=== SetDesirableKeyboardLayout ===
+
Locks exit process of pressing X to close in HOME Menu for an application or HOME button for an applet. When locked, it will show the "waiting for software to be closed dialog" until UnlockExit is called or a 15 seconds timeout (when the latter occurs, the process is force-terminated).
−
Takes an input u32, no output.
     −
The input u32 is "nn::settings::KeyboardLayout".
+
=== UnlockExit ===
 +
No input/output.
   −
=== CreateManagedDisplayLayer ===
+
Unlocks exit process, if LockExit was previously used.
−
Returns an output u64 LayerId which is then used by the user-process with [[Display_services#OpenLayer]].
     −
=== IsSystemBufferSharingEnabled ===
+
=== EnterFatalSection ===
 
No input/output.
 
No input/output.
   −
Not available when the current applet is an Application ([[#AppletId]] == 0x01).
+
=== LeaveFatalSection ===
 +
No input/output.
   −
Checks whether SystemBufferSharing is enabled, throwing an error otherwise.
+
[[#EnterFatalSection]] must be executed at least once before executing this command, otherwise error code 0x40080 will be returned. EnterFatalSection and LeaveFatalSection work in pairs, that is, N calls to EnterFatalSection must be performed first in order to perform N executions of LeaveFatalSection. Essentially, these two functions operate like how one would lock and unlock a recursive mutex.
   −
=== GetSystemSharedLayerHandle ===
+
=== GetLibraryAppletLaunchableEvent ===
−
No input, returns two output u64s "nn::vi::fbshare::SharedBufferHandle" and "nn::vi::fbshare::SharedLayerHandle".
+
No input, returns an output event handle with autoclear=false.
   −
Runs code similar to [[#IsSystemBufferSharingEnabled]] first.
+
=== SetScreenShotPermission ===
 +
Takes an input s32. No output.
   −
=== GetSystemSharedBufferHandle ===
+
Controls whether screenshot-capture is allowed.
−
No input, returns an output u64 "nn::vi::fbshare::SharedBufferHandle".
     −
Runs code similar to [[#IsSystemBufferSharingEnabled]] first.
+
{| class="wikitable" border="1"
−
 
+
|-
−
Same as [[#GetSystemSharedLayerHandle]] except this just gets the SharedBufferHandle.
+
! Value || Description
 +
|-
 +
| 0 || Inherit from parent applet
 +
|-
 +
| 1 || Enable
 +
|-
 +
| 2 || Disable
 +
|-
 +
|}
 +
 
 +
=== SetOperationModeChangedNotification ===
 +
Takes an input u8 bool flag. No output.
 +
 
 +
=== SetPerformanceModeChangedNotification ===
 +
Takes an input u8 bool flag. No output.
   −
=== SetHandlesRequestToDisplay ===
+
=== SetFocusHandlingMode ===
−
Takes an input u8 bool, no output.
+
Takes 3 input u8s with each field located immediately after the previous u8, these are bool flags. No output.
   −
Sets an internal state flag. When the input flag is 0, this will in additional run the same code as [[#ApproveToDisplay]].
+
=== SetRestartMessageEnabled ===
 +
Takes an input u8 bool flag, no output.
    
See [[#AppletMessage]].
 
See [[#AppletMessage]].
   −
=== ApproveToDisplay ===
+
=== SetScreenShotAppletIdentityInfo ===
−
No input/output.
+
Takes an input [[#AppletIdentityInfo]], no output.
   −
Used to handle the notification enabled by [[#SetHandlesRequestToDisplay]].
+
=== SetOutOfFocusSuspendingEnabled ===
 +
Takes an input u8 bool flag. No output.
   −
=== OverrideAutoSleepTimeAndDimmingTime ===
+
=== SetControllerFirmwareUpdateSection ===
−
Takes 4 input s32s, no output.
+
Takes an input u8 bool flag, no output.
   −
=== SetMediaPlaybackState ===
+
This throws error 0x40280 when the internal state flag already matches the input value.
−
Takes an input u8 bool, no output.
     −
=== SetIdleTimeDetectionExtension ===
+
=== SetRequiresCaptureButtonShortPressedMessage ===
−
Takes an input u32, no output.
+
Takes an input u8 bool flag, no output.
 +
 
 +
See [[#AppletMessage]].
   −
The input value must be 0-2: 0 = disabled, 1 = Extended, and 2 = ExtendedUnsafe.
+
When enabled with a non-Overlay applet, Overlay applet will not be notified of capture button short-presses for screenshots.
   −
=== GetIdleTimeDetectionExtension ===
+
=== SetAlbumImageOrientation ===
−
No input, returns an output u32.
+
Takes an input u32 "nn::album::ImageOrientation". No output.
   −
Returns the value set by [[#SetIdleTimeDetectionExtension]].
+
The input value must not be >3.
   −
=== SetInputDetectionSourceSet ===
+
=== SetDesirableKeyboardLayout ===
 
Takes an input u32, no output.
 
Takes an input u32, no output.
   −
=== ReportUserIsActive ===
+
The input u32 is "nn::settings::KeyboardLayout".
 +
 
 +
=== CreateManagedDisplayLayer ===
 +
Returns an output u64 LayerId which is then used by the user-process with [[Display_services#OpenLayer]].
 +
 
 +
=== IsSystemBufferSharingEnabled ===
 
No input/output.
 
No input/output.
   −
Uses idle:sys ReportUserIsActive.
+
Not available when the current applet is an Application ([[#AppletId]] == 0x01).
   −
Reports that the user is active, for idle detection (screen dimming / auto-sleep). This is equivalent to when the user uses HID input.
+
Checks whether SystemBufferSharing is enabled, throwing an error otherwise.
   −
=== GetCurrentIlluminance ===
+
=== GetSystemSharedLayerHandle ===
−
No input, returns an output float.
+
No input, returns two output u64s "nn::vi::fbshare::SharedBufferHandle" and "nn::vi::fbshare::SharedLayerHandle".
   −
Uses [[Backlight_services|lbl]] command GetAmbientLightSensorValue, where only the output float is used.
+
Runs code similar to [[#IsSystemBufferSharingEnabled]] first.
   −
=== IsIlluminanceAvailable ===
+
=== GetSystemSharedBufferHandle ===
−
No input, returns an output u8 bool.
+
No input, returns an output u64 "nn::vi::fbshare::SharedBufferHandle".
   −
Uses [[Backlight_services|lbl]] command IsAmbientLightSensorAvailable.
+
Runs code similar to [[#IsSystemBufferSharingEnabled]] first.
   −
User-processes can use this to determine whether to continue with using GetCurrentIlluminance(Ex).
+
Same as [[#GetSystemSharedLayerHandle]] except this just gets the SharedBufferHandle.
   −
=== SetAutoSleepDisabled ===
+
=== CreateManagedDisplaySeparableLayer ===
−
Takes an input u8 bool, no output.
+
No input, returns two output u64 LayerIds.
   −
=== IsAutoSleepDisabled ===
+
sdknso now uses this instead of [[#CreateManagedDisplayLayer]]. sdknso caches the output from the cmd so that it's only used once. The first u64 is used the same as the original LayerId from [[#CreateManagedDisplayLayer]]. <code>nn::vi::CreateRecordingLayer</code> uses the second LayerId, the layer creation is identical besides which LayerId is used.
−
No input, returns an output u8 bool.
     −
=== ReportMultimediaError ===
+
=== SetManagedDisplayLayerSeparationMode ===
−
Takes an input Result and a type-0x5 input buffer, no output.
+
Takes an input u32, no output.
   −
The buffer contains a 0x138-byte "movie::MultimediaTelemetryReport" struct.
+
sdknso exposes this as <code>nn::vi::SetRecordingLayerEnabled(bool)</code>.
   −
=== GetCurrentIlluminanceEx ===
+
The input u32 must be 0-1.
−
No input, returns an output u8 bool and float.
     −
Uses [[Backlight_services|lbl]] command GetAmbientLightSensorValue.
+
=== SetRecordingLayerCompositionEnabled ===
 +
Takes an input bool, no output.
   −
=== SetWirelessPriorityMode ===
+
=== SetHandlesRequestToDisplay ===
−
Takes an input s32 enum '''WirelessPriorityMode''', no output.
+
Takes an input u8 bool, no output.
   −
The input value must be 1 or 2.
+
Sets an internal state flag. When the input flag is 0, this will in additional run the same code as [[#ApproveToDisplay]].
   −
=== GetAccumulatedSuspendedTickValue ===
+
See [[#AppletMessage]].
−
No input, returns an output u64 tick value.
     −
Gets the total time in ticks that the process was suspended, relative to when the applet-service was last initialized.
+
=== ApproveToDisplay ===
 +
No input/output.
   −
=== GetAccumulatedSuspendedTickChangedEvent ===
+
Used to handle the notification enabled by [[#SetHandlesRequestToDisplay]].
−
No input, returns an output Event handle with autoclear=true.
     −
This is signaled when the output from [[#GetAccumulatedSuspendedTickValue]] is updated.
+
=== OverrideAutoSleepTimeAndDimmingTime ===
 +
Takes 4 input s32s, no output.
   −
=== SetAlbumImageTakenNotificationEnabled ===
+
=== SetMediaPlaybackState ===
 
Takes an input u8 bool, no output.
 
Takes an input u8 bool, no output.
   −
See [[#AppletMessage]].
+
=== SetIdleTimeDetectionExtension ===
 +
Takes an input u32, no output.
 +
 
 +
The input value must be 0-2: 0 = disabled, 1 = Extended, and 2 = ExtendedUnsafe.
 +
 
 +
=== GetIdleTimeDetectionExtension ===
 +
No input, returns an output u32.
 +
 
 +
Returns the value set by [[#SetIdleTimeDetectionExtension]].
   −
=== SetApplicationAlbumUserData ===
+
=== SetInputDetectionSourceSet ===
−
Takes a type-0x21 input buffer, no output.
+
Takes an input u32, no output.
   −
The buffer contains arbitrary UserData.
+
=== ReportUserIsActive ===
 +
No input/output.
   −
The size must be <=0x400. The input buffer is copied to a buffer loaded from a state ptr (throwing an error when the state ptr is not set), with the u32 size being written to statebuf+0x400 afterwards.
+
Uses idle:sys ReportUserIsActive.
   −
=== GetDebugStorageChannel ===
+
Reports that the user is active, for idle detection (screen dimming / auto-sleep). This is equivalent to when the user uses HID input.
−
No input, returns an output [[#IStorageChannel]].
     −
The cached value loaded from [[System_Settings|system-setting]] <code>am.debug!dev_function</code> must be set to 0x1 with size 0x1, otherwise an error is returned.
+
=== GetCurrentIlluminance ===
 +
No input, returns an output float.
   −
== IStorageChannel ==
+
Uses [[Backlight_services|lbl]] command GetAmbientLightSensorValue, where only the output float is used.
−
Added with [[7.0.0]].
     −
{| class="wikitable" border="1"
+
=== IsIlluminanceAvailable ===
−
|-
+
No input, returns an output u8 bool.
−
! Cmd || Name || Notes
  −
|-
  −
| 0 || Push || No input, returns an output [[#IStorage]].
  −
|-
  −
| 1 || Unpop || No input, returns an output [[#IStorage]].
  −
|-
  −
| 2 || Pop || No input, returns an output [[#IStorage]].
  −
|-
  −
| 3 || GetPopEventHandle || No input, returns an output handle.
  −
|-
  −
| 4 || Clear || No input/output.
  −
|}
     −
== IWindowController ==
+
Uses [[Backlight_services|lbl]] command IsAmbientLightSensorAvailable.
−
{| class="wikitable" border="1"
  −
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 0 || [[#CreateWindow]] ||
  −
|-
  −
| 1 || [[#GetAppletResourceUserId]] ||
  −
|-
  −
| 2 || [6.0.0+] [[#GetAppletResourceUserIdOfCallerApplet]] ||
  −
|-
  −
| 10 || [[#AcquireForegroundRights]] ||
  −
|-
  −
| 11 || [[#ReleaseForegroundRights]] ||
  −
|-
  −
| 12 || [[#RejectToChangeIntoBackground]] ||
  −
|-
  −
| 20 || [7.0.0+] [[#SetAppletWindowVisibility]] ||
  −
|-
  −
| 21 || [7.0.0+] [[#SetAppletGpuTimeSlice]] ||
  −
|}
     −
=== CreateWindow ===
+
User-processes can use this to determine whether to continue with using GetCurrentIlluminance(Ex).
−
Takes an input u32, returns an output [[#IWindow]].
     −
Stubbed, just returns an error.
+
=== SetAutoSleepDisabled ===
 +
Takes an input u8 bool, no output.
   −
=== GetAppletResourceUserId ===
+
=== IsAutoSleepDisabled ===
−
No input, returns an output u64 [[#AppletResourceUserId]].
+
No input, returns an output u8 bool.
   −
=== GetAppletResourceUserIdOfCallerApplet ===
+
=== ReportMultimediaError ===
−
No input, returns an output u64 [[#AppletResourceUserId]].
+
Takes an input Result and a type-0x5 input buffer, no output.
   −
=== AcquireForegroundRights ===
+
The buffer contains a 0x138-byte "movie::MultimediaTelemetryReport" struct.
−
No input/output.
     −
Just returns 0.
+
=== GetCurrentIlluminanceEx ===
 +
No input, returns an output u8 bool and float.
   −
=== ReleaseForegroundRights ===
+
Uses [[Backlight_services|lbl]] command GetAmbientLightSensorValue.
−
No input/output.
     −
Just returns 0.
+
=== SetInputDetectionPolicy ===
 +
Takes an input [[#InputDetectionPolicy]], no output.
   −
=== RejectToChangeIntoBackground ===
+
=== SetWirelessPriorityMode ===
−
No input/output.
+
Takes an input s32 [[#WirelessPriorityMode]], no output.
   −
Just returns 0.
+
=== GetAccumulatedSuspendedTickValue ===
 +
No input, returns an output u64 tick value.
   −
=== SetAppletWindowVisibility ===
+
Gets the total time in ticks that the process was suspended, relative to when the applet-service was last initialized.
−
Takes an input u8 bool, no output.
     −
=== SetAppletGpuTimeSlice ===
+
=== GetAccumulatedSuspendedTickChangedEvent ===
−
Takes an input s64, no output.
+
No input, returns an output Event handle with autoclear=true.
   −
The input s64 must not be negative.
+
This is signaled when the output from [[#GetAccumulatedSuspendedTickValue]] is updated.
   −
== IAudioController ==
+
=== SetAlbumImageTakenNotificationEnabled ===
−
{| class="wikitable" border="1"
+
Takes an input u8 bool, no output.
−
|-
  −
! Cmd || Name
  −
|-
  −
| 0 || [[#SetExpectedMasterVolume]]
  −
|-
  −
| 1 || [[#GetMainAppletExpectedMasterVolume]]
  −
|-
  −
| 2 || [[#GetLibraryAppletExpectedMasterVolume]]
  −
|-
  −
| 3 || [[#ChangeMainAppletMasterVolume]]
  −
|-
  −
| 4 || [[#SetTransparentVolumeRate]]
  −
|}
     −
GetMainAppletExpectedMasterVolume/SetExpectedMasterVolume are used for saving/restoring state for LibraryApplet launching, with SetExpectedMasterVolume being used with new state prior to launching a LibraryApplet. With official sw these applet funcs are used directly in the main-codebin.
+
See [[#AppletMessage]].
   −
=== SetExpectedMasterVolume ===
+
=== SetApplicationAlbumUserData ===
−
Takes two input floats, no output.
+
Takes a type-0x21 input buffer, no output.
   −
Writes the input floats to state: first one is used by [[#GetMainAppletExpectedMasterVolume]], second one is used by [[#GetLibraryAppletExpectedMasterVolume]].
+
The buffer contains arbitrary UserData.
   −
=== GetMainAppletExpectedMasterVolume ===
+
The size must be <=0x400. The input buffer is copied to a buffer loaded from a state ptr (throwing an error when the state ptr is not set), with the u32 size being written to statebuf+0x400 afterwards.
−
No input, returns an output float.
     −
=== GetLibraryAppletExpectedMasterVolume ===
+
=== SaveCurrentScreenshot ===
−
No input, returns an output float.
+
Takes an input s32 [[Capture_services#AlbumReportOption|AlbumReportOption]], no output.
   −
=== ChangeMainAppletMasterVolume ===
+
sdknso exposes this under "nn::album::".
−
Takes an input float and an input u64, no output.
     −
=== SetTransparentVolumeRate ===
+
=== SetRecordVolumeMuted ===
−
Takes an input float, no output.
+
Takes an input bool, no output.
 +
 
 +
=== GetDebugStorageChannel ===
 +
No input, returns an output [[#IStorageChannel]].
 +
 
 +
The cached value loaded from [[System_Settings|system-setting]] <code>am.debug!dev_function</code> must be set to 0x1 with size 0x1, otherwise an error is returned.
 +
 
 +
== IStorageChannel ==
 +
This is "nn::am::service::IStorageChannel".
 +
 
 +
This was added with [7.0.0+].
   −
== IDisplayController ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 0 || [[#GetLastForegroundCaptureImage]]
+
| 0 || Push || No input, returns an output [[#IStorage]].
 
|-
 
|-
−
| 1 || [[#UpdateLastForegroundCaptureImage]]
+
| 1 || Unpop || No input, returns an output [[#IStorage]].
 
|-
 
|-
−
| 2 || [[#GetLastApplicationCaptureImage]]
+
| 2 || Pop || No input, returns an output [[#IStorage]].
 
|-
 
|-
−
| 3 || [[#GetCallerAppletCaptureImage]]
+
| 3 || GetPopEventHandle || No input, returns an output handle.
 
|-
 
|-
−
| 4 || [[#UpdateCallerAppletCaptureImage]]
+
| 4 || Clear || No input/output.
 +
|}
 +
 
 +
== IWindowController ==
 +
This is "nn::am::service::IWindowController".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 5 || [[#GetLastForegroundCaptureImageEx]]
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 6 || [[#GetLastApplicationCaptureImageEx]]
+
| 0 || [[#CreateWindow]] ||
 
|-
 
|-
−
| 7 || [[#GetCallerAppletCaptureImageEx]]
+
| 1 || [[#GetAppletResourceUserId]] ||
 
|-
 
|-
−
| 8 || [2.0.0+] [[#TakeScreenShotOfOwnLayer]]
+
| 2 || [6.0.0+] [[#GetAppletResourceUserIdOfCallerApplet]] ||
 
|-
 
|-
−
| 9 || [5.0.0+] [[#CopyBetweenCaptureBuffers]]
+
| 10 || [[#AcquireForegroundRights]] ||
 
|-
 
|-
−
| 10 || [[#AcquireLastApplicationCaptureBuffer]]
+
| 11 || [[#ReleaseForegroundRights]] ||
 
|-
 
|-
−
| 11 || [[#ReleaseLastApplicationCaptureBuffer]]
+
| 12 || [[#RejectToChangeIntoBackground]] ||
 
|-
 
|-
−
| 12 || [[#AcquireLastForegroundCaptureBuffer]]
+
| 20 || [7.0.0+] [[#SetAppletWindowVisibility]] ||
 
|-
 
|-
−
| 13 || [[#ReleaseLastForegroundCaptureBuffer]]
+
| 21 || [7.0.0+] [[#SetAppletGpuTimeSlice]] ||  
−
|-
+
|}
−
| 14 || [[#AcquireCallerAppletCaptureBuffer]]
+
 
−
|-
+
=== CreateWindow ===
−
| 15 || [[#ReleaseCallerAppletCaptureBuffer]]
+
Takes an input u32, returns an output [[#IWindow]].
−
|-
+
 
−
| 16 || [[#AcquireLastApplicationCaptureBufferEx]]
+
Stubbed, just returns an error.
−
|-
+
 
−
| 17 || [[#AcquireLastForegroundCaptureBufferEx]]
+
=== GetAppletResourceUserId ===
−
|-
+
No input, returns an output u64 [[#AppletResourceUserId]].
−
| 18 || [[#AcquireCallerAppletCaptureBufferEx]]
+
 
−
|-
+
=== GetAppletResourceUserIdOfCallerApplet ===
−
| 20 || [3.0.0+] [[#ClearCaptureBuffer]]
+
No input, returns an output u64 [[#AppletResourceUserId]].
−
|-
+
 
−
| 21 || [3.0.0+] [[#ClearAppletTransitionBuffer]]
+
=== AcquireForegroundRights ===
−
|-
+
No input/output.
−
| 22 || [4.0.0+] [[#AcquireLastApplicationCaptureSharedBuffer]]
+
 
−
|-
+
Just returns 0.
−
| 23 || [4.0.0+] [[#ReleaseLastApplicationCaptureSharedBuffer]]
  −
|-
  −
| 24 || [4.0.0+] [[#AcquireLastForegroundCaptureSharedBuffer]]
  −
|-
  −
| 25 || [4.0.0+] [[#ReleaseLastForegroundCaptureSharedBuffer]]
  −
|-
  −
| 26 || [4.0.0+] [[#AcquireCallerAppletCaptureSharedBuffer]]
  −
|-
  −
| 27 || [4.0.0+] [[#ReleaseCallerAppletCaptureSharedBuffer]]
  −
|-
  −
| 28 || [6.0.0+] [[#TakeScreenShotOfOwnLayerEx]]
  −
|}
     −
=== GetLastForegroundCaptureImage ===
+
=== ReleaseForegroundRights ===
−
Takes a type-0x6 output buffer.
+
No input/output.
   −
Stubbed, just returns an error.
+
Just returns 0.
   −
=== UpdateLastForegroundCaptureImage ===
+
=== RejectToChangeIntoBackground ===
 
No input/output.
 
No input/output.
   −
=== GetLastApplicationCaptureImage ===
+
Just returns 0.
−
Takes a type-0x6 output buffer.
     −
Stubbed, just returns an error.
+
=== SetAppletWindowVisibility ===
 +
Takes an input u8 bool, no output.
   −
=== GetCallerAppletCaptureImage ===
+
=== SetAppletGpuTimeSlice ===
−
Takes a type-0x6 output buffer.
+
Takes an input s64, no output.
   −
Stubbed, just returns an error.
+
The input s64 must not be negative.
   −
=== UpdateCallerAppletCaptureImage ===
+
== IAudioController ==
−
No input/output.
+
This is "nn::am::service::IAudioController".
   −
Calls the same func internally as [[#UpdateLastForegroundCaptureImage]], except this passes param value 2 instead of 1.
+
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 +
|-
 +
| 0 || [[#SetExpectedMasterVolume]]
 +
|-
 +
| 1 || [[#GetMainAppletExpectedMasterVolume]]
 +
|-
 +
| 2 || [[#GetLibraryAppletExpectedMasterVolume]]
 +
|-
 +
| 3 || [[#ChangeMainAppletMasterVolume]]
 +
|-
 +
| 4 || [[#SetTransparentVolumeRate]]
 +
|}
   −
=== GetLastForegroundCaptureImageEx ===
+
GetMainAppletExpectedMasterVolume/SetExpectedMasterVolume are used for saving/restoring state for LibraryApplet launching, with SetExpectedMasterVolume being used with new state prior to launching a LibraryApplet. With official sw these applet funcs are used directly in the main-codebin.
−
Takes a type-0x6 output buffer, returns an output u8 bool.
     −
The buffer size must match 0x384000.
+
=== SetExpectedMasterVolume ===
 +
Takes two input floats, no output.
   −
=== GetLastApplicationCaptureImageEx ===
+
Writes the input floats to state: first one is used by [[#GetMainAppletExpectedMasterVolume]], second one is used by [[#GetLibraryAppletExpectedMasterVolume]].
−
Takes a type-0x6 output buffer, returns an output u8 bool.
     −
The buffer size must match 0x384000.
+
=== GetMainAppletExpectedMasterVolume ===
 +
No input, returns an output float.
   −
Calls the same internal func as [[#GetLastForegroundCaptureImageEx]], except that the last param is set to value 0 instead of 1.
+
=== GetLibraryAppletExpectedMasterVolume ===
 +
No input, returns an output float.
   −
=== GetCallerAppletCaptureImageEx ===
+
=== ChangeMainAppletMasterVolume ===
−
Takes a type-0x6 output buffer, returns an output u8 bool.
+
Takes an input float and an input u64, no output.
   −
The buffer size must match 0x384000.
+
=== SetTransparentVolumeRate ===
 +
Takes an input float, no output.
   −
Calls the same internal func as [[#GetLastForegroundCaptureImageEx]], except that the last param is set to value 2 instead of 1.
+
== IDisplayController ==
−
 
+
This is "nn::am::service::IDisplayController".
−
=== TakeScreenShotOfOwnLayer ===
+
 
−
Takes an input u8 bool and a s32, no output.
+
{| class="wikitable" border="1"
−
 
+
|-
−
=== CopyBetweenCaptureBuffers ===
+
! Cmd || Name
−
Takes two input s32s, no output.
+
|-
−
 
+
| 0 || [[#GetLastForegroundCaptureImage]]
−
=== AcquireLastApplicationCaptureBuffer ===
+
|-
−
No input, returns an output handle.
+
| 1 || [[#UpdateLastForegroundCaptureImage]]
−
 
+
|-
−
Stubbed, just returns an error.
+
| 2 || [[#GetLastApplicationCaptureImage]]
−
 
+
|-
−
=== ReleaseLastApplicationCaptureBuffer ===
+
| 3 || [[#GetCallerAppletCaptureImage]]
−
No input/output.
+
|-
−
 
+
| 4 || [[#UpdateCallerAppletCaptureImage]]
−
Clears a state field if it's not already 0, returning an error otherwise. On newer sysvers: then a func is called which just returns 0, then this cmd returns 0.
+
|-
−
 
+
| 5 || [[#GetLastForegroundCaptureImageEx]]
−
=== AcquireLastForegroundCaptureBuffer ===
+
|-
−
No input, returns an output handle.
+
| 6 || [[#GetLastApplicationCaptureImageEx]]
−
 
+
|-
−
Stubbed, just returns an error.
+
| 7 || [[#GetCallerAppletCaptureImageEx]]
−
 
+
|-
−
=== ReleaseLastForegroundCaptureBuffer ===
+
| 8 || [2.0.0+] [[#TakeScreenShotOfOwnLayer]]
−
No input/output.
+
|-
−
 
+
| 9 || [5.0.0+] [[#CopyBetweenCaptureBuffers]]
−
Same as [[#ReleaseLastApplicationCaptureBuffer]] except with a different state field + different input param for the called func.
+
|-
−
 
+
| 10 || [[#AcquireLastApplicationCaptureBuffer]]
−
=== AcquireCallerAppletCaptureBuffer ===
+
|-
−
No input, returns an output handle.
+
| 11 || [[#ReleaseLastApplicationCaptureBuffer]]
 +
|-
 +
| 12 || [[#AcquireLastForegroundCaptureBuffer]]
 +
|-
 +
| 13 || [[#ReleaseLastForegroundCaptureBuffer]]
 +
|-
 +
| 14 || [[#AcquireCallerAppletCaptureBuffer]]
 +
|-
 +
| 15 || [[#ReleaseCallerAppletCaptureBuffer]]
 +
|-
 +
| 16 || [[#AcquireLastApplicationCaptureBufferEx]]
 +
|-
 +
| 17 || [[#AcquireLastForegroundCaptureBufferEx]]
 +
|-
 +
| 18 || [[#AcquireCallerAppletCaptureBufferEx]]
 +
|-
 +
| 20 || [3.0.0+] [[#ClearCaptureBuffer]]
 +
|-
 +
| 21 || [3.0.0+] [[#ClearAppletTransitionBuffer]]
 +
|-
 +
| 22 || [4.0.0+] [[#AcquireLastApplicationCaptureSharedBuffer]]
 +
|-
 +
| 23 || [4.0.0+] [[#ReleaseLastApplicationCaptureSharedBuffer]]
 +
|-
 +
| 24 || [4.0.0+] [[#AcquireLastForegroundCaptureSharedBuffer]]
 +
|-
 +
| 25 || [4.0.0+] [[#ReleaseLastForegroundCaptureSharedBuffer]]
 +
|-
 +
| 26 || [4.0.0+] [[#AcquireCallerAppletCaptureSharedBuffer]]
 +
|-
 +
| 27 || [4.0.0+] [[#ReleaseCallerAppletCaptureSharedBuffer]]
 +
|-
 +
| 28 || [6.0.0+] [[#TakeScreenShotOfOwnLayerEx]]
 +
|}
 +
 
 +
=== GetLastForegroundCaptureImage ===
 +
Takes a type-0x6 output buffer.
    
Stubbed, just returns an error.
 
Stubbed, just returns an error.
   −
=== ReleaseCallerAppletCaptureBuffer ===
+
=== UpdateLastForegroundCaptureImage ===
 
No input/output.
 
No input/output.
   −
Same as [[#ReleaseLastApplicationCaptureBuffer]] except with a different state field + different input param for the called func.
+
=== GetLastApplicationCaptureImage ===
 +
Takes a type-0x6 output buffer.
   −
=== AcquireLastApplicationCaptureBufferEx ===
+
Stubbed, just returns an error.
−
No input, returns an output TransferMemory handle and an output u8 bool.
     −
The state field used by [[#ReleaseLastApplicationCaptureBuffer]] must be 0. Calls a func which just returns an error (this is only the case on newer sysvers), hence this cmd will just return that error. If that func would have returned successfully, the state field would be set to 1 and the cmd would return 0.
+
=== GetCallerAppletCaptureImage ===
 +
Takes a type-0x6 output buffer.
   −
On old sysvers, the output TransferMemory is size 0x384000 with permissions=RW.
+
Stubbed, just returns an error.
   −
=== AcquireLastForegroundCaptureBufferEx ===
+
=== UpdateCallerAppletCaptureImage ===
−
No input, returns an output TransferMemory handle and an output u8 bool.
+
No input/output.
   −
Same as [[#AcquireLastApplicationCaptureBufferEx]] except this uses the [[#ReleaseLastForegroundCaptureBuffer]] state field, and uses a different input param value for the called func.
+
Calls the same func internally as [[#UpdateLastForegroundCaptureImage]], except this passes param value 2 instead of 1.
   −
=== AcquireCallerAppletCaptureBufferEx ===
+
=== GetLastForegroundCaptureImageEx ===
−
No input, returns an output TransferMemory handle and an output u8 bool.
+
Takes a type-0x6 output buffer, returns an output u8 bool.
   −
Same as [[#AcquireLastApplicationCaptureBufferEx]] except this uses the [[#ReleaseCallerAppletCaptureBuffer]] state field, and uses a different input param value for the called func.
+
The buffer size must match 0x384000.
   −
=== ClearCaptureBuffer ===
+
=== GetLastApplicationCaptureImageEx ===
−
Takes an input u8 bool, an s32, and an u32, returns no output.
+
Takes a type-0x6 output buffer, returns an output u8 bool.
   −
=== ClearAppletTransitionBuffer ===
+
The buffer size must match 0x384000.
−
Takes an input u32, no output.
     −
=== AcquireLastApplicationCaptureSharedBuffer ===
+
Calls the same internal func as [[#GetLastForegroundCaptureImageEx]], except that the last param is set to value 0 instead of 1.
−
No input, returns an output u8 bool and an s32.
     −
This loads data from state.
+
=== GetCallerAppletCaptureImageEx ===
 +
Takes a type-0x6 output buffer, returns an output u8 bool.
   −
=== ReleaseLastApplicationCaptureSharedBuffer ===
+
The buffer size must match 0x384000.
−
No input/output.
+
 
 +
Calls the same internal func as [[#GetLastForegroundCaptureImageEx]], except that the last param is set to value 2 instead of 1.
 +
 
 +
=== TakeScreenShotOfOwnLayer ===
 +
Takes an input u8 bool and a s32, no output.
   −
Depending on whether a state field is 0, this just returns an error or returns 0.
+
=== CopyBetweenCaptureBuffers ===
 +
Takes two input s32s, no output.
   −
=== AcquireLastForegroundCaptureSharedBuffer ===
+
=== AcquireLastApplicationCaptureBuffer ===
−
No input, returns an output u8 bool and an s32.
+
No input, returns an output handle.
   −
Calls the same func internally as [[#AcquireLastApplicationCaptureSharedBuffer]], except this passes value 1 for the last param instead of 0.
+
Stubbed, just returns an error.
   −
=== ReleaseLastForegroundCaptureSharedBuffer ===
+
=== ReleaseLastApplicationCaptureBuffer ===
 
No input/output.
 
No input/output.
   −
Calls the same func internally as [[#ReleaseLastApplicationCaptureSharedBuffer]], except this passes value 1 for the last param instead of 0.
+
Clears a state field if it's not already 0, returning an error otherwise. On newer sysvers: then a func is called which just returns 0, then this cmd returns 0.
   −
=== AcquireCallerAppletCaptureSharedBuffer ===
+
=== AcquireLastForegroundCaptureBuffer ===
−
No input, returns an output u8 bool and an s32.
+
No input, returns an output handle.
   −
Calls the same func internally as [[#AcquireLastApplicationCaptureSharedBuffer]], except this passes value 2 for the last param instead of 0.
+
Stubbed, just returns an error.
   −
=== ReleaseCallerAppletCaptureSharedBuffer ===
+
=== ReleaseLastForegroundCaptureBuffer ===
 
No input/output.
 
No input/output.
   −
Calls the same func internally as [[#ReleaseLastApplicationCaptureSharedBuffer]], except this passes value 2 for the last param instead of 0.
+
Same as [[#ReleaseLastApplicationCaptureBuffer]] except with a different state field + different input param for the called func.
   −
=== TakeScreenShotOfOwnLayerEx ===
+
=== AcquireCallerAppletCaptureBuffer ===
−
Takes two input u8 bools and a s32, no output.
+
No input, returns an output handle.
   −
Calls the same func internally as [[#TakeScreenShotOfOwnLayer]], except the last bool param is the last cmd param bool instead of hard-coded 0. This flag indicates whether the screenshot should be taken Immediately.
+
Stubbed, just returns an error.
   −
== ISystemAppletControllerForDebug ==
+
=== ReleaseCallerAppletCaptureBuffer ===
−
{| class="wikitable" border="1"
+
No input/output.
−
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 1 || RequestLaunchApplicationForDebug ||
  −
|-
  −
| 2 || [7.0.0+] GetDebugStorageChannel || No input, returns an output [[#IStorageChannel]].
  −
|-
  −
| 3 || [7.0.0+] CreateStorageForDebug || Takes a total of 8-bytes of input, returns an [[#IStorage]].
  −
|}
     −
== IProcessWindingController ==
+
Same as [[#ReleaseLastApplicationCaptureBuffer]] except with a different state field + different input param for the called func.
−
{| class="wikitable" border="1"
  −
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 0 || [[#GetLaunchReason]] ||
  −
|-
  −
| 11 || [[#OpenCallingLibraryApplet]] ||
  −
|-
  −
| 21 || [[#PushContext]] ||
  −
|-
  −
| 22 || [[#PopContext]] ||
  −
|-
  −
| 23 || [[#CancelWindingReservation]] ||
  −
|-
  −
| 30 || [[#WindAndDoReserved]] ||
  −
|-
  −
| 40 || [[#ReserveToStartAndWaitAndUnwindThis]] ||
  −
|-
  −
| 41 || [4.0.0+] [[#ReserveToStartAndWait]] ||
  −
|}
     −
=== GetLaunchReason ===
+
=== AcquireLastApplicationCaptureBufferEx ===
−
No input, returns an output [[#AppletProcessLaunchReason]].
+
No input, returns an output TransferMemory handle and an output u8 bool.
 +
 
 +
The state field used by [[#ReleaseLastApplicationCaptureBuffer]] must be 0. Calls a func which just returns an error (this is only the case on newer sysvers), hence this cmd will just return that error. If that func would have returned successfully, the state field would be set to 1 and the cmd would return 0.
   −
Used by LibraryApplets.
+
On old sysvers, the output TransferMemory is size 0x384000 with permissions=RW.
   −
=== OpenCallingLibraryApplet ===
+
=== AcquireLastForegroundCaptureBufferEx ===
−
No input, returns an output [[#ILibraryAppletAccessor]].
+
No input, returns an output TransferMemory handle and an output u8 bool.
   −
The objptr from state is cleared during this, an error is thrown if it's already 0.
+
Same as [[#AcquireLastApplicationCaptureBufferEx]] except this uses the [[#ReleaseLastForegroundCaptureBuffer]] state field, and uses a different input param value for the called func.
   −
=== PushContext ===
+
=== AcquireCallerAppletCaptureBufferEx ===
−
Takes an input [[#IStorage]], no output.
+
No input, returns an output TransferMemory handle and an output u8 bool.
   −
=== PopContext ===
+
Same as [[#AcquireLastApplicationCaptureBufferEx]] except this uses the [[#ReleaseCallerAppletCaptureBuffer]] state field, and uses a different input param value for the called func.
−
No input, returns an output [[#IStorage]].
     −
=== CancelWindingReservation ===
+
=== ClearCaptureBuffer ===
−
No input/output.
+
Takes an input u8 bool, a s32 CaptureSharedBuffer, and an u32 color, returns no output.
   −
=== WindAndDoReserved ===
+
Clear the input CaptureSharedBuffer with the specified RGBA8 color.
−
No input/output.
     −
=== ReserveToStartAndWaitAndUnwindThis ===
+
=== ClearAppletTransitionBuffer ===
−
Takes an input [[#ILibraryAppletAccessor]], no output.
+
Takes an input u32, no output.
   −
=== ReserveToStartAndWait ===
+
Clear the AppletTransitionBuffer with the specified RGBA8 color.
−
Takes an input [[#ILibraryAppletAccessor]], no output.
     −
== IDebugFunctions ==
+
=== AcquireLastApplicationCaptureSharedBuffer ===
−
{| class="wikitable" border="1"
+
No input, returns an output u8 bool and an s32.
−
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 0 || [[#NotifyMessageToHomeMenuForDebug]] ||
  −
|-
  −
| 1 || [[#OpenMainApplication]] ||
  −
|-
  −
| 10 || [[#PerformSystemButtonPressing]] ||
  −
|-
  −
| 20 || [[#InvalidateTransitionLayer]] ||
  −
|-
  −
| 30 || [6.0.0+] [[#RequestLaunchApplicationWithUserAndArgumentForDebug]] ||
  −
|-
  −
| 40 || [6.0.0+] [[#GetAppletResourceUsageInfo]] ||
  −
|-
  −
| 100 || [7.0.0+] [[#SetCpuBoostModeForApplet]] ||
  −
|}
     −
=== NotifyMessageToHomeMenuForDebug ===
+
This loads data from state.
−
Takes an input [[#AppletMessage]], no output.
     −
Stubbed, just returns an error.
+
=== ReleaseLastApplicationCaptureSharedBuffer ===
 +
No input/output.
   −
=== OpenMainApplication ===
+
Depending on whether a state field is 0, this just returns an error or returns 0.
−
No input, returns an output [[#IApplicationAccessor]].
     −
Should not be used when no Application is running (svcBreak).
+
=== AcquireLastForegroundCaptureSharedBuffer ===
 +
No input, returns an output u8 bool and an s32.
   −
=== PerformSystemButtonPressing ===
+
Calls the same func internally as [[#AcquireLastApplicationCaptureSharedBuffer]], except this passes value 1 for the last param instead of 0.
−
Takes an input [[#SystemButtonType]], no output.
     −
=== InvalidateTransitionLayer ===
+
=== ReleaseLastForegroundCaptureSharedBuffer ===
 
No input/output.
 
No input/output.
   −
=== RequestLaunchApplicationWithUserAndArgumentForDebug ===
+
Calls the same func internally as [[#ReleaseLastApplicationCaptureSharedBuffer]], except this passes value 1 for the last param instead of 0.
−
Takes an input u8 bool flag, an u64 Application titleID, a type-0x5 input buffer containing an array of u128 userIDs, and a type-0x5 input buffer, no output.
     −
Requests to launch the specified Application, with the specified users. When the bool flag is true, the content of the second input buffer is used to create a storage which is pushed to the UserChannel for this Application (see [[#LaunchParameterKind]]).
+
=== AcquireCallerAppletCaptureSharedBuffer ===
 +
No input, returns an output u8 bool and an s32.
   −
=== GetAppletResourceUsageInfo ===
+
Calls the same func internally as [[#AcquireLastApplicationCaptureSharedBuffer]], except this passes value 2 for the last param instead of 0.
−
No input, returns an output [[#AppletResourceUsageInfo]].
+
 
 +
=== ReleaseCallerAppletCaptureSharedBuffer ===
 +
No input/output.
 +
 
 +
Calls the same func internally as [[#ReleaseLastApplicationCaptureSharedBuffer]], except this passes value 2 for the last param instead of 0.
 +
 
 +
=== TakeScreenShotOfOwnLayerEx ===
 +
Takes two input u8 bools and a s32, no output.
   −
=== SetCpuBoostModeForApplet ===
+
Calls the same func internally as [[#TakeScreenShotOfOwnLayer]], except the last bool param is the last cmd param bool instead of hard-coded 0. This flag indicates whether the screenshot should be taken Immediately.
−
Takes an input u32 '''CpuBoostMode''' (only modes 0 and 1 are valid) and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].
     −
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
+
== ISystemAppletControllerForDebug ==
 +
This is "nn::am::service::ISystemAppletControllerForDebug".
   −
== IStorage ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 1 || RequestLaunchApplicationForDebug
 +
|-
 +
| 2 || [7.0.0+] [[#GetDebugStorageChannel]]
 
|-
 
|-
−
| 0 || Open || No input. Returns an [[#IStorageAccessor]].
+
| 3 || [7.0.0+] [[#CreateStorageForDebug]]
 
|-
 
|-
−
| 1 || [2.0.0+] OpenTransferStorage || No input. Returns an [[#ITransferStorageAccessor]].
+
| 4 || [12.0.0+] [[#CreateCradleFirmwareUpdaterForDebug]]
 
|}
 
|}
   −
Open can only be used when the IStorage was created by [[#CreateStorage]] or [[#CreateTransferMemoryStorage]]. OpenTransferStorage can only be used when the IStorage was created by [[#CreateHandleStorage]].
+
=== GetDebugStorageChannel ===
 +
No input. Returns an output [[#IStorageChannel]].
 +
 
 +
=== CreateStorageForDebug ===
 +
Takes a total of 8-bytes of input. Returns an [[#IStorage]].
 +
 
 +
=== CreateCradleFirmwareUpdaterForDebug ===
 +
No input. Returns an [[#ICradleFirmwareUpdater]].
   −
Only 1 *Accessor session can be open for each IStorage at a time.
+
== IProcessWindingController ==
 +
This is "nn::am::service::IProcessWindingController".
   −
== IStorageAccessor ==
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
 
! Cmd || Name || Notes
 
! Cmd || Name || Notes
 
|-
 
|-
−
| 0 || GetSize || No input. Returns an s64.
+
| 0 || [[#GetLaunchReason]] ||
 +
|-
 +
| 11 || [[#OpenCallingLibraryApplet]] ||  
 
|-
 
|-
−
| 10 || Write || Takes an input s64 and a type-0x21 input buffer.
+
| 21 || [[#PushContext]] ||  
 
|-
 
|-
−
| 11 || Read || Takes an input s64 and a type-0x22 output buffer.
+
| 22 || [[#PopContext]] ||  
−
|}
+
|-
−
 
+
| 23 || [[#CancelWindingReservation]] ||
−
== ITransferStorageAccessor ==
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
! Cmd || Name || Notes
+
| 30 || [[#WindAndDoReserved]] ||
 
|-
 
|-
−
| 0 || GetSize || No input. Returns an output s64.
+
| 40 || [[#ReserveToStartAndWaitAndUnwindThis]] ||  
 
|-
 
|-
−
| 1 || GetHandle || No input. Returns an output s64 and handle.
+
| 41 || [4.0.0+] [[#ReserveToStartAndWait]] ||
 
|}
 
|}
   −
These commands return the data originally from [[#CreateHandleStorage]] input, both return the same s64.
+
=== GetLaunchReason ===
 +
No input, returns an output [[#AppletProcessLaunchReason]].
   −
= appletOE =
+
Used by LibraryApplets.
−
This is "nn::am::service::IApplicationProxyService".
     −
{| class="wikitable" border="1"
+
=== OpenCallingLibraryApplet ===
−
|-
+
No input, returns an output [[#ILibraryAppletAccessor]].
−
! Cmd || Name || Notes
  −
|-
  −
| 0 || [[#OpenApplicationProxy]] ||
  −
|}
     −
This is used by all regular-applications, including [[flog]] and "Retail Interactive Display Menu". Only one session can be open for this service at a time.
+
The objptr from state is cleared during this, an error is thrown if it's already 0.
   −
== OpenApplicationProxy ==
+
=== PushContext ===
−
Returns an [[#IApplicationProxy]]. See [[#appletAE]].
+
Takes an input [[#IStorage]], no output.
   −
Takes a [[IPC_Marshalling|reserved]] input u64 (official user-processes use hard-coded value 0), a PID, and a process copy-handle (cur-proc handle alias).
+
=== PopContext ===
 +
No input, returns an output [[#IStorage]].
   −
On failure, official user-processes will retry using this command in a loop while the retval is 0x19280, with svcSleepThread(10000000) being called first.
+
=== CancelWindingReservation ===
 +
No input/output.
   −
= idle:sys =
+
=== WindAndDoReserved ===
−
This is "nn::idle::detail::IPolicyManagerSystem"
+
No input/output.
   −
{| class="wikitable" border="1"
+
=== ReserveToStartAndWaitAndUnwindThis ===
−
|-
+
Takes an input [[#ILibraryAppletAccessor]], no output.
−
! Cmd || Name
  −
|-
  −
| 0 || GetAutoPowerDownEvent
  −
|-
  −
|rowspan="2"| 1 || [1.0.0-3.0.2]
  −
|-
  −
| [7.0.0+]
  −
|-
  −
| 2 || [1.0.0-3.0.2]
  −
|-
  −
| 3 || SetHandlingContext
  −
|-
  −
| 4 || LoadAndApplySettings
  −
|-
  −
| 5 || ReportUserIsActive
  −
|}
     −
[3.0.0+] SetHandlingContext now takes an additional 0x10-bytes of input.
+
=== ReserveToStartAndWait ===
 +
Takes an input [[#ILibraryAppletAccessor]], no output.
   −
= omm =
+
== IDebugFunctions ==
−
This is "nn::omm::detail::IOperationModeManager"
+
This is "nn::am::service::IDebugFunctions".
−
 
  −
Operation Mode Manager (OMM) is a service responsible for arbitrating the operation changes between docked and handheld modes.
  −
Besides [[PTM_services]], this is the only service that interacts with the [[Dock]] through [[USB_services|usb:pd*]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Cmd || Name || Notes
+
! Cmd || Name
 +
|-
 +
| 0 || [[#NotifyMessageToHomeMenuForDebug]]
 
|-
 
|-
−
| 0 || GetOperationMode ||  
+
| 1 || [1.0.0-9.2.0] [[#OpenMainApplication]]
 
|-
 
|-
−
| 1 || GetOperationModeChangeEvent ||  
+
| 10 || [[#PerformSystemButtonPressing]]
 
|-
 
|-
−
| 2 || EnableAudioVisual ||  
+
| 20 || [[#InvalidateTransitionLayer]]
 
|-
 
|-
−
| 3 || DisableAudioVisual ||  
+
| 30 || [6.0.0+] [[#RequestLaunchApplicationWithUserAndArgumentForDebug]]
 
|-
 
|-
−
| 4 || EnterSleepAndWait ||  
+
| 31 || [12.0.0+] RequestLaunchApplicationByApplicationLaunchInfoForDebug
 
|-
 
|-
−
| 5 || GetCradleStatus ||  
+
| 40 || [6.0.0+] [[#GetAppletResourceUsageInfo]]
 
|-
 
|-
−
| 6 || FadeInDisplay ||  
+
| 50 || [15.0.0+] AddSystemProgramIdAndAppletIdForDebug
 
|-
 
|-
−
| 7 || FadeOutDisplay ||  
+
| 51 || [16.0.0+] AddOperationConfirmedLibraryAppletIdForDebug
 
|-
 
|-
−
| 8 || [2.0.0+] GetCradleFwVersion ||
+
| 52 || [17.0.0+] GetProgramIdFromAppletIdForDebug
 
|-
 
|-
−
| 9 || [2.0.0+] NotifyCecSettingsChanged ||
+
| 53 || [18.0.0+]  
 
|-
 
|-
−
| 10 || [3.0.0+] SetOperationModePolicy ||
+
| 100 || [7.0.0+] [[#SetCpuBoostModeForApplet]]
 
|-
 
|-
−
| 11 || [3.0.0+] GetDefaultDisplayResolution ||
+
| 101 || [10.0.0+] [[#CancelCpuBoostModeForApplet]]
 
|-
 
|-
−
| 12 || [3.0.0+] GetDefaultDisplayResolutionChangeEvent ||
+
| 110 || [9.0.0+] [[#PushToAppletBoundChannelForDebug]]
 
|-
 
|-
−
| 13 || [3.0.0+] UpdateDefaultDisplayResolution ||
+
| 111 || [9.0.0+] [[#TryPopFromAppletBoundChannelForDebug]]
 
|-
 
|-
−
| 14 || [3.0.0+] ShouldSleepOnBoot ||
+
| 120 || [9.0.0+] [[#AlarmSettingNotificationEnableAppEventReserve]]
 
|-
 
|-
−
| 15 || [4.0.0+] NotifyHdcpApplicationExecutionStarted ||
+
| 121 || [9.0.0+] [[#AlarmSettingNotificationDisableAppEventReserve]]
 
|-
 
|-
−
| 16 || [4.0.0+] NotifyHdcpApplicationExecutionFinished ||
+
| 122 || [9.0.0+] [[#AlarmSettingNotificationPushAppEventNotify]]
 
|-
 
|-
−
| 17 || [4.0.0+] NotifyHdcpApplicationDrawingStarted ||
+
| 130 || [9.0.0+] [[#FriendInvitationSetApplicationParameter]]
 
|-
 
|-
−
| 18 || [4.0.0+] NotifyHdcpApplicationDrawingFinished ||
+
| 131 || [9.0.0+] [[#FriendInvitationClearApplicationParameter]]
 
|-
 
|-
−
| 19 || [4.0.0+] GetHdcpAuthenticationFailedEvent ||
+
| 132 || [9.0.0+] [[#FriendInvitationPushApplicationParameter]]
 
|-
 
|-
−
| 20 || [4.0.0+] GetHdcpAuthenticationFailedEmulationEnabled ||
+
| 140 || [14.0.0+] RestrictPowerOperationForSecureLaunchModeForDebug
 
|-
 
|-
−
| 21 || [4.0.0+] SetHdcpAuthenticationFailedEmulation ||
+
| 200 || [15.0.0+] CreateFloatingLibraryAppletAccepterForDebug
 
|-
 
|-
−
| 22 || [4.0.0+] GetHdcpStateChangeEvent ||
+
| 300 || [16.0.0+] TerminateAllRunningApplicationsForDebug
 
|-
 
|-
−
| 23 || [4.0.0+] GetHdcpState ||
+
| 410 || [18.0.0+]  
 
|-
 
|-
−
| 24 || [5.0.0+] ShowCardUpdateProcessing ||
+
| 411 || [18.0.0+]  
 
|-
 
|-
−
| 25 || [5.0.0+] SetApplicationCecSettingsAndNotifyChanged ||
+
| 412 || [18.0.0+]  
 
|-
 
|-
−
| 26 || [7.0.0+] ||
+
| 900 || [12.0.0+] GetGrcProcessLaunchedSystemEvent
 
|}
 
|}
   −
== Cmd26 ==
+
=== NotifyMessageToHomeMenuForDebug ===
−
No input, returns an output u32.
+
Takes an input [[#AppletMessage]], no output.
   −
This is used by [[#GetOperationModeSystemInfo]].
+
Stubbed, just returns an error.
   −
= spsm =
+
=== OpenMainApplication ===
−
This is "nn::spsm::detail::IPowerStateInterface".
+
No input, returns an output [[#IApplicationAccessor]].
   −
{| class="wikitable" border="1"
+
Should not be used when no Application is running (svcBreak).
−
|-
  −
! Cmd || Name
  −
|-
  −
| 0 || GetState
  −
|-
  −
| 1 || SleepSystemAndWaitAwake
  −
|-
  −
| 2 ||
  −
|-
  −
| 3 ||
  −
|-
  −
| 4 || GetNotificationMessageEventHandle
  −
|-
  −
| 5 ||
  −
|-
  −
| 6 ||
  −
|-
  −
| 7 ||
  −
|-
  −
| 8 || AnalyzePerformanceLogForLastSleepWakeSequence
  −
|-
  −
| 9 || ChangeHomeButtonLongPressingTime
  −
|-
  −
| 10 ||
  −
|-
  −
| 11 || [1.0.0-3.0.2]
  −
|}
     −
[3.0.0+] Cmd11 now takes a total of 8-bytes of input.
+
=== PerformSystemButtonPressing ===
 +
Takes an input [[#SystemButtonType]], no output.
   −
= tcap =
+
=== InvalidateTransitionLayer ===
−
This is "nn::tcap::server::IManager".
+
No input/output.
   −
{| class="wikitable" border="1"
+
=== RequestLaunchApplicationWithUserAndArgumentForDebug ===
−
|-
+
Takes an input u8 bool flag, an [[NCM_services#ApplicationId|ApplicationId]], a type-0x5 input buffer containing an array of u128 userIDs, and a type-0x5 input buffer, no output.
−
! Cmd || Name
  −
|-
  −
| 0 || GetContinuousHighSkinTemperatureEvent
  −
|-
  −
| 1 || SetOperationMode
  −
|-
  −
| 2 || LoadAndApplySettings
  −
|}
     −
= caps:su =
+
Requests to launch the specified Application, with the specified users. When the bool flag is true, the content of the second input buffer is used to create a storage which is pushed to the UserChannel for this Application (see [[#LaunchParameterKind]]).
−
This is "nn::capsrv::sf::IScreenShotApplicationService".
     −
This was added with [[6.0.0]].
+
=== GetAppletResourceUsageInfo ===
 +
No input, returns an output [[#AppletResourceUsageInfo]].
   −
This can be used by applications to save screenshots.
+
=== SetCpuBoostModeForApplet ===
 +
Takes an input u32 [[#CpuBoostMode]] and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].
   −
{| class="wikitable" border="1"
+
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
−
|-
  −
! Cmd || Name || Notes
  −
|-
  −
| 32 || [7.0.0+] SetShimLibraryVersion || Takes a total of 0x10-bytes of input and a PID, no output.
  −
|-
  −
| 201 || SaveScreenShot ||
  −
|-
  −
| 203 || SaveScreenShotEx0 ||
  −
|-
  −
| 205 || [8.0.0+] SaveScreenShotEx1 ||
  −
|-
  −
| 210 || SaveScreenShotEx2 || Takes a total of 0x50-bytes of input, a type-0x15 input buffer, and a type-0x45 input buffer.  Returns a total of 0x20-bytes of output.
  −
|}
     −
'''SetShimLibraryVersion''' is a wrapper for [[Capture_services|caps:c]] cmd33. Commands '''SaveScreenShot''', '''SaveScreenShotEx0''', '''SaveScreenShotEx1''' and '''SaveScreenShotEx2''' are wrappers for [[Display_services|caps:sc]] cmd210.
+
=== CancelCpuBoostModeForApplet ===
 +
No input/output.
   −
== SaveScreenShot ==
+
=== PushToAppletBoundChannelForDebug ===
−
Takes two input u32s, an u64 AppletResourceUserId, a PID, and a type-0x45 input buffer. Returns a 0x20-byte struct '''ApplicationAlbumEntry'''.
+
Takes an input [[#IStorage]] and a s32, no output.
 +
 
 +
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
 +
 
 +
The s32 must match the value already stored in state when the state value is non-zero, otherwise an error is returned. When the state value is 0, the s32 is written into state. Then the input storage is pushed to the StorageChannel.
 +
 
 +
=== TryPopFromAppletBoundChannelForDebug ===
 +
Takes an input s32, returns an output [[#IStorage]].
 +
 
 +
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
 +
 
 +
The s32 must not be 0 and must match the value previously saved by [[#PushToAppletBoundChannelForDebug]], otherwise errors are returned. Then the output storage is popped from the StorageChannel.
 +
 
 +
=== AlarmSettingNotificationEnableAppEventReserve ===
 +
Takes an input [[#IStorage]] and an [[NCM_services#ApplicationId|ApplicationId]], no output.
 +
 
 +
Clears a StorageChannel, pushes the input storage there, and writes the ApplicationId into state.
 +
 
 +
=== AlarmSettingNotificationDisableAppEventReserve ===
 +
No input/output.
 +
 
 +
Clears the StorageChannel/saved-ApplicationId used by [[#AlarmSettingNotificationEnableAppEventReserve]].
 +
 
 +
=== AlarmSettingNotificationPushAppEventNotify ===
 +
Takes an input [[#IStorage]], no output.
   −
Official user-processes doesn't use this, instead [[#SaveScreenShotEx0]] is used: ScreenShotAttributeEx0 is all-zero except +0 is set to an input u32.
+
Same as [[#PushToNotificationStorageChannel]] except this uses the MainApplication.
   −
== SaveScreenShotEx0 ==
+
=== FriendInvitationSetApplicationParameter ===
−
Takes an input 0x40-byte struct '''ScreenShotAttributeEx0''', an input u32, an input u64 AppletResourceUserId, a PID, and a type-0x45 input buffer. Returns a 0x20-byte struct '''ApplicationAlbumEntry'''.
+
Takes an input [[#IStorage]] and an [[NCM_services#ApplicationId|ApplicationId]], no output.
   −
= Library Applets =
+
Clears a StorageChannel, pushes the input storage there, and writes the ApplicationId into state.
−
This section documents library applet launching.
     −
Before starting the applet, [[#IStorage]]s are [[#ILibraryAppletCreator|created]] and written, then passed to [[#ILibraryAppletAccessor]] PushInData. The [[#IStorage]] session is closed afterwards. The first [[#IStorage]] is [[#CommonArguments]], followed by any applet-specific [[#IStorage]]s.
+
=== FriendInvitationClearApplicationParameter ===
 +
No input/output.
   −
Once the applet finishes running successfully, [[#ILibraryAppletAccessor]] PopOutData can be used to get the applet-specific [[#IStorage]] containing the applet output data.
+
Clears the StorageChannel/saved-ApplicationId used by [[#FriendInvitationSetApplicationParameter]].
   −
== CommonArguments ==
+
=== FriendInvitationPushApplicationParameter ===
−
The first [[#CreateStorage|IStorage]] passed to applets should contain the common library applet arguments. This is populated by <code>nn::la::CommonArgumentsWriter</code> and has the following format.
+
Takes an input [[#IStorage]], no output.
   −
This struct is 0x20-bytes.
+
Same as [[#PushToFriendInvitationStorageChannel]] except this uses the MainApplication.
   −
Official sw handles the first 8-bytes separately, which is a header. With CommonArguments version 0x0, the header is 4-bytes, while starting with version 0x1 it's 8-bytes.
+
== IStorage ==
 +
This is "nn::am::service::IStorage".
    
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Offset || Size || Typical Value || Notes  
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 0x0 || 4 || 1 || Common Arguments version
+
| 0 || Open || No input. Returns an [[#IStorageAccessor]].
 
|-
 
|-
−
| 0x4 || 4 || 0x20 || Common Arguments size
+
| 1 || [2.0.0+] OpenTransferStorage || No input. Returns an [[#ITransferStorageAccessor]].
−
|-
+
|}
−
| 0x8 || 4 || || Library applet version (API version)
+
 
 +
Open can only be used when the IStorage was created by [[#CreateStorage]] or [[#CreateTransferMemoryStorage]]. OpenTransferStorage can only be used when the IStorage was created by [[#CreateHandleStorage]].
 +
 
 +
Only 1 *Accessor session can be open for each IStorage at a time.
 +
 
 +
== IStorageAccessor ==
 +
This is "nn::am::service::IStorageAccessor".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 0xC || 4 || 0 || Theme color
+
! Cmd || Name || Notes
 
|-
 
|-
−
| 0x10 || 1 || 0 || Play startup sound
+
| 0 || GetSize || No input. Returns an s64.
 
|-
 
|-
−
| 0x18 || 8 || N/A || System tick (see [[SVC#svcGetSystemTick|svcGetSystemTick]])
+
| 10 || Write || Takes an input s64 and a type-0x21 input buffer.
 
|-
 
|-
 +
| 11 || Read || Takes an input s64 and a type-0x22 output buffer.
 
|}
 
|}
   −
= Enums =
+
== ITransferStorageAccessor ==
−
=== AppletId ===
+
This is "nn::am::service::ITransferStorageAccessor".
−
See also [[:Category:Library Applets]].
      
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! ID
+
! Cmd || Name || Notes
−
!  Title-id
  −
!  Description
   
|-
 
|-
−
| 0x01
+
| 0 || GetSize || No input. Returns an output s64.
−
|  
  −
| Application. Not valid for use with LibraryApplets.
   
|-
 
|-
−
| 0x02
+
| 1 || GetHandle || No input. Returns an output s64 and handle.
−
| 010000000000100C
+
|}
−
| "overlayDisp"
+
 
 +
These commands return the data originally from [[#CreateHandleStorage]] input, both return the same s64.
 +
 
 +
= appletOE =
 +
This is "nn::am::service::IApplicationProxyService".
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 0x03
+
! Cmd || Name || Notes
−
| 0100000000001000
  −
| "qlaunch"
   
|-
 
|-
−
| 0x04
+
| 0 || [[#OpenApplicationProxy]] ||
−
| 0100000000001012
+
|}
−
| "starter" SystemApplication.
+
 
 +
This is used by all regular-applications, including [[flog]] and "Retail Interactive Display Menu". Only one session can be open for this service at a time.
 +
 
 +
== OpenApplicationProxy ==
 +
Returns an [[#IApplicationProxy]]. See [[#appletAE]].
 +
 
 +
Takes a [[IPC_Marshalling|reserved]] input u64 (official user-processes use hard-coded value 0), a PID, and a process copy-handle (cur-proc handle alias).
 +
 
 +
On failure, official user-processes will retry using this command in a loop while the retval is 0x19280, with svcSleepThread(10000000) being called first.
 +
 
 +
= idle:sys =
 +
This is "nn::idle::detail::IPolicyManagerSystem"
 +
 
 +
This was moved to [[OMM_services|omm]] with [14.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 
|-
 
|-
−
| 0x0A
+
! Cmd || Name
−
| 0100000000001001
  −
| [[Auth_Applet|"auth"]]
   
|-
 
|-
−
| 0x0B
+
| 0 || GetAutoPowerDownEvent
−
| 0100000000001002
  −
| "cabinet"
   
|-
 
|-
−
| 0x0C
+
| 1 || [7.0.0+] IsAutoPowerDownRequested ([1.0.0-3.0.2] )
−
| 0100000000001003
  −
| "controller"
   
|-
 
|-
−
| 0x0D
+
| 2 || [1.0.0-3.0.2]
−
| 0100000000001004
  −
| "dataErase"
   
|-
 
|-
−
| 0x0E
+
| 3 || [[#SetHandlingContext]]
−
| 0100000000001005
  −
| [[Error_Applet|"error"]]
   
|-
 
|-
−
| 0x0F
+
| 4 || LoadAndApplySettings
−
| 0100000000001006
  −
| "netConnect"
   
|-
 
|-
−
| 0x10
+
| 5 || ReportUserIsActive
−
| 0100000000001007
+
|}
−
| [[Profile_Selector|"playerSelect"]]
+
 
 +
== SetHandlingContext ==
 +
[3.0.0+] Now takes an additional 0x10-bytes of input.
 +
 
 +
[13.0.0+] Total input size is now 0x30 instead of 0x38.
 +
 
 +
= omm =
 +
This is "nn::omm::detail::IOperationModeManager"
 +
 
 +
Operation Mode Manager (OMM) is a service responsible for arbitrating the operation changes between docked and handheld modes.
 +
Besides [[PTM_services|PTM]], this is the only service that interacts with the [[Dock]] through [[USB_services|usb:pd*]].
 +
 
 +
This was moved to [[OMM_services|omm]] with [14.0.0+].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Cmd || Name
 
|-
 
|-
−
| 0x11
+
| 0 || GetOperationMode
−
| 0100000000001008
  −
| [[Software_Keyboard|"swkbd"]]
   
|-
 
|-
−
| 0x12
+
| 1 || GetOperationModeChangeEvent
−
| 0100000000001009
  −
| "miiEdit"
   
|-
 
|-
−
| 0x13
+
| 2 || EnableAudioVisual
−
| 010000000000100A
  −
| "LibAppletWeb" [[Internet_Browser#010000000000100A|WebApplet]] applet
   
|-
 
|-
−
| 0x14
+
| 3 || DisableAudioVisual
−
| 010000000000100B
  −
| "LibAppletShop" [[Internet_Browser#ShopN|ShopN]] applet
   
|-
 
|-
−
| 0x15
+
| 4 || EnterSleepAndWait
−
| 010000000000100D
  −
| "photoViewer"
   
|-
 
|-
−
| 0x16
+
| 5 || GetCradleStatus
−
| 010000000000100E
  −
| "set"
   
|-
 
|-
−
| 0x17
+
| 6 || FadeInDisplay
−
| 010000000000100F
  −
| "LibAppletOff" [[Internet_Browser#Offline_Applet|Offline]] applet
   
|-
 
|-
−
| 0x18
+
| 7 || FadeOutDisplay
−
| 0100000000001010
  −
| "LibAppletLns" [[Internet_Browser#Whitelisted_Applets|Whitelisted]] applet
   
|-
 
|-
−
| 0x19
+
| 8 || [2.0.0+] GetCradleFwVersion
−
| 0100000000001011
  −
| "LibAppletAuth" [[Internet_Browser#WifiWebAuthApplet|WifiWebAuth]] applet
   
|-
 
|-
−
| 0x1A
+
| 9 || [2.0.0+] NotifyCecSettingsChanged
−
| 0100000000001013
+
|-
−
| "myPage"
+
| 10 || [3.0.0+] SetOperationModePolicy
−
|}
+
|-
−
 
+
| 11 || [3.0.0+] GetDefaultDisplayResolution
−
=== LibraryAppletMode ===
+
|-
−
{| class="wikitable" border="1"
+
| 12 || [3.0.0+] GetDefaultDisplayResolutionChangeEvent
 
|-
 
|-
−
!  ID
+
| 13 || [3.0.0+] UpdateDefaultDisplayResolution
−
!  Description
   
|-
 
|-
−
| 0x0
+
| 14 || [3.0.0+] ShouldSleepOnBoot
−
| AllForeground
   
|-
 
|-
−
| 0x1
+
| 15 || [4.0.0+] NotifyHdcpApplicationExecutionStarted
−
| Background
   
|-
 
|-
−
| 0x2
+
| 16 || [4.0.0+] NotifyHdcpApplicationExecutionFinished
−
| No UI
   
|-
 
|-
−
| 0x3
+
| 17 || [4.0.0+] NotifyHdcpApplicationDrawingStarted
−
| Background with indirect display, see also [[#GetIndirectLayerConsumerHandle]]. Only used by swkbd InlineKeyboard.
   
|-
 
|-
−
| 0x4
+
| 18 || [4.0.0+] NotifyHdcpApplicationDrawingFinished
−
| AllForegroundInitiallyHidden. Can be used by [7.0.0+] [[Internet_Browser|WebSession]].
   
|-
 
|-
−
|}
+
| 19 || [4.0.0+] GetHdcpAuthenticationFailedEvent
−
 
  −
=== AppletMessage ===
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
!  ID
+
| 20 || [4.0.0+] GetHdcpAuthenticationFailedEmulationEnabled
−
!  Description
   
|-
 
|-
−
| 0x4 || Exit requested
+
| 21 || [4.0.0+] SetHdcpAuthenticationFailedEmulation
 
|-
 
|-
−
| 0xF || [[#GetCurrentFocusState|FocusState]] changed
+
| 22 || [4.0.0+] GetHdcpStateChangeEvent
 
|-
 
|-
−
| 0x10 || Current applet execution was [[#SetRestartMessageEnabled|resumed]].
+
| 23 || [4.0.0+] GetHdcpState
 
|-
 
|-
−
| 0x1E || OperationMode changed
+
| 24 || [5.0.0+] ShowCardUpdateProcessing
 
|-
 
|-
−
| 0x1F || PerformanceMode changed
+
| 25 || [5.0.0+] SetApplicationCecSettingsAndNotifyChanged
 
|-
 
|-
−
| 0x33 || [[#SetHandlesRequestToDisplay|RequestToDisplay]]. Indicates that [[#ApproveToDisplay]] should be used.
+
| 26 || [7.0.0+] [[#GetOperationModeSystemInfo]]
 
|-
 
|-
−
| 0x5A || Capture button was [[#SetRequiresCaptureButtonShortPressedMessage|short-pressed]].
+
| 27 || [9.0.0+] GetAppletFullAwakingSystemEvent
 
|-
 
|-
−
| 0x5C || Screenshot was [[#SetAlbumImageTakenNotificationEnabled|taken]].
+
| 28 || [12.0.0+] [[#CreateCradleFirmwareUpdater]]
 
|}
 
|}
   −
This is "nn::am::AppletMessage".
+
== GetOperationModeSystemInfo ==
 +
No input, returns an output u32.
 +
 
 +
This is used by [[#GetOperationModeSystemInfo|ICommonStateGetter GetOperationModeSystemInfo]].
 +
 
 +
== CreateCradleFirmwareUpdater ==
 +
No input. Returns an [[#ICradleFirmwareUpdater]].
 +
 
 +
== ICradleFirmwareUpdater ==
 +
This is "nn::am::service::ICradleFirmwareUpdater".
 +
 
 +
This was added with [12.0.0+].
   −
=== OperationMode ===
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Cmd || Name
−
!  Description
   
|-
 
|-
−
| 0 || Handheld
+
| 0 || Start
 +
|-
 +
| 1 || Finish
 
|-
 
|-
−
| 1 || Docked
+
| 2 || GetUpdateDeviceStatus
−
|}
  −
 
  −
=== TvPowerStateMatchingMode ===
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
!  Value
+
| 3 || GetUpdateProgress
−
!  Description
   
|-
 
|-
−
| 0 || Unknown
+
| 4 || GetUpdateDeviceStatusChangeEvent
 
|-
 
|-
−
| 1 || Unknown
+
| 5 || GetUpdateProgress2
 
|}
 
|}
   −
This is "nn::oe::TvPowerStateMatchingMode". This is used with [[#SetTvPowerStateMatchingMode]].
+
= spsm =
 +
This is "nn::spsm::detail::IPowerStateInterface".
 +
 
 +
This was moved to [[OMM_services|omm]] with [14.0.0+].
   −
=== SystemButtonType ===
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Cmd || Name
−
!  Description
   
|-
 
|-
−
| 1 || PerformHomeButtonShortPressing
+
| 0 || GetCurrentState
 +
|-
 +
| 1 || EnterSleep
 
|-
 
|-
−
| 2 || PerformHomeButtonLongPressing
+
| 2 || GetLastWakeReason
 
|-
 
|-
−
| 3 || Short-pressing with the Power-button. Only available with [[#PerformSystemButtonPressing]].
+
| 3 || Shutdown
 
|-
 
|-
−
| 4 || Long-pressing with the Power-button. Only available with [[#PerformSystemButtonPressing]].
+
| 4 || GetNotificationMessageEventHandle
 
|-
 
|-
−
| 5 || Shutdown the system. Only available with [[#PerformSystemButtonPressing]].
+
| 5 || ReceiveNotificationMessage
 
|-
 
|-
−
| 6 || PerformCaptureButtonShortPressing
+
| 6 || AnalyzeLogForLastSleepWakeSequence
 
|-
 
|-
−
| 7 || PerformCaptureButtonLongPressing
+
| 7 || ResetEventLog
−
|}
  −
 
  −
This is "nn::am::service::SystemButtonType". This is used with [[#PerformSystemButtonPressingIfInFocus]]/[[#PerformSystemButtonPressing]].
  −
 
  −
=== LaunchParameterKind ===
  −
{| class="wikitable" border="1"
   
|-
 
|-
−
!  Value
+
| 8 || AnalyzePerformanceLogForLastSleepWakeSequence
−
!  Description
   
|-
 
|-
−
| 1 || UserChannel. Application-specific LaunchParameter.
+
| 9 || ChangeHomeButtonLongPressingTime
 
|-
 
|-
−
| 2 || account PreselectedUser
+
| 10 || PutErrorState
 
|-
 
|-
−
| 3 || Unknown if used by anything?
+
| 11 || [1.0.0-3.0.2] InvalidateCurrentHomeButtonPressing
 
|}
 
|}
   −
=== LibraryAppletExitReason ===
+
[3.0.0+] Cmd11 now takes a total of 8-bytes of input.
 +
 
 +
= tcap =
 +
This is "nn::tcap::server::IManager".
 +
 
 +
This was removed with [11.0.0+].
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Cmd || Name
−
!  Description
   
|-
 
|-
−
| 0 || Normal
+
| 0 || GetContinuousHighSkinTemperatureEvent
 
|-
 
|-
−
| 1 || Canceled
+
| 1 || SetOperationMode
 
|-
 
|-
−
| 2 || Abnormal
+
| 2 || LoadAndApplySettings
−
|-
  −
| 10 || Unexpected
   
|}
 
|}
   −
=== ProgramSpecifyKind ===
+
= caps:su =
 +
This is "nn::capsrv::sf::IScreenShotApplicationService".
 +
 
 +
This was added with [6.0.0+].
 +
 
 +
This can be used by applications to save screenshots.
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Value
+
! Cmd || Name || Notes
−
!  Description
+
|-
 +
| 32 || [7.0.0+] SetShimLibraryVersion || Takes a total of 0x10-bytes of input and a PID, no output.
 
|-
 
|-
−
| 0 || u8 ProgramIndex. "ExecuteProgram". [[NS_Services|NS]] handles ProgramIndex by launching titleID {application_titleID}+ProgramIndex. After using [[#ExecuteProgram]] with this successfully, official user-processes will enter an infinite loop with sleep-thread value 86400000000000.
+
| 201 || SaveScreenShot ||  
 
|-
 
|-
−
| 1 || u64 titleID. "JumpToSubApplicationProgramForDevelopment". Only available when [[Settings_services#GetDebugModeFlag|DebugMode]] is 1.
+
| 203 || SaveScreenShotEx0 ||  
 
|-
 
|-
−
| 2 || u64 = value 0. "RestartProgram"
+
| 205 || [8.0.0+] SaveScreenShotEx1 ||
 
|-
 
|-
 +
| 210 || SaveScreenShotEx2 || Takes a total of 0x50-bytes of input, a type-0x15 input buffer, and a type-0x45 input buffer.  Returns a total of 0x20-bytes of output.
 
|}
 
|}
   −
This is "nn::am::service::ProgramSpecifyKind". This controls the type of the u64 passed to [[#ExecuteProgram]].
+
'''SetShimLibraryVersion''' is a wrapper for [[Capture_services|caps:c]] cmd33. Commands '''SaveScreenShot''', '''SaveScreenShotEx0''', '''SaveScreenShotEx1''' and '''SaveScreenShotEx2''' are wrappers for [[Display_services|caps:sc]] cmd210.
 +
 
 +
== SaveScreenShot ==
 +
Takes two input u32s, an u64 AppletResourceUserId, a PID, and a type-0x45 input buffer containing image data. Returns an [[Capture_services|ApplicationAlbumEntry]].
 +
 
 +
Official user-processes doesn't use this, instead [[#SaveScreenShotEx0]] is used: ScreenShotAttributeEx0 is all-zero, except +4 is set to an input u32 and u32 +0xC = 0x1.
 +
 
 +
This cmd internally uses an all-zero ScreenShotAttributeEx0, with u32 +0 = input u32 and u32 +0x8 = 0x3.
 +
 
 +
== SaveScreenShotEx0 ==
 +
Takes an input 0x40-byte struct '''ScreenShotAttributeEx0''', an input u32, an input u64 AppletResourceUserId, a PID, and a type-0x45 input buffer containing image data. Returns an [[Capture_services|ApplicationAlbumEntry]].
 +
 
 +
== SaveScreenShotEx1 ==
 +
Takes an input 0x40-byte struct '''ScreenShotAttributeEx0''', an input u32, an input u64 AppletResourceUserId, a PID, a type-0x15 input buffer containing an [[Capture_services|ApplicationData]], and a type-0x45 input buffer containing image data. Returns an [[Capture_services|ApplicationAlbumEntry]].
 +
 
 +
== SaveScreenShotEx2 ==
 +
Takes an input 0x40-byte struct '''ScreenShotAttributeEx0''', an input u32, an input u64 AppletResourceUserId, a type-0x15 input buffer containing an [[Capture_services|UserIdList]], and a type-0x45 input buffer containing image data. Returns an [[Capture_services|ApplicationAlbumEntry]].
 +
 
 +
= apm =
 +
This is "nn::am::service::IApmManager".
   −
= AppletResourceUserId =
+
This was added with [8.0.0+].
−
This u64 is officially called "nn::applet::AppletResourceUserId". Used by a number of non-AM services.
     −
= AppletAttribute =
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Offset || Size || Description
+
! Cmd || Name
 +
|-
 +
| 0 || [[#OpenSession]]
 
|-
 
|-
−
| 0x0 || 0x1 || Flag. When non-zero, two state fields are set to 1.
+
| 1 || GetPerformanceMode
 
|-
 
|-
−
| 0x1 || 0x7F || Unused
+
| 6 || [7.0.0+] [[#IsCpuOverclockEnabled]]
 
|}
 
|}
   −
This is "nn::am::AppletAttribute". This struct is 0x8-bytes.
+
== OpenSession ==
 +
Returns an [[#ISession]].
 +
 
 +
== IsCpuOverclockEnabled ==
 +
No input, returns an output u8 bool.
   −
This is used by [[#OpenLibraryAppletProxy]].
+
== ISession ==
 +
This is "nn::am::service::IApmSession".
   −
= AppletProcessLaunchReason =
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Offset || Size || Description
+
! Cmd || Name
 
|-
 
|-
−
| 0x0 || 0x1 || Flag. When non-zero, LibraryApplets then use [[#OpenCallingLibraryApplet]].
+
| 0 || SetPerformanceConfiguration
 
|-
 
|-
−
| 0x1 || 0x2 || Always 0.
+
| 1 || GetPerformanceConfiguration
 
|-
 
|-
−
| 0x3 || 0x1 || Always 0.
+
| 2 || [8.0.0+] SetCpuOverclockEnabled
 
|}
 
|}
   −
This is "nn::am::service::AppletProcessLaunchReason". This struct is 0x4-bytes.
+
= Library Applets =
 +
This section documents library applet launching.
 +
 
 +
Before starting the applet, [[#IStorage]]s are [[#ILibraryAppletCreator|created]] and written, then passed to [[#ILibraryAppletAccessor]] PushInData. The [[#IStorage]] session is closed afterwards. The first [[#IStorage]] is [[#CommonArguments]], followed by any applet-specific [[#IStorage]]s.
 +
 
 +
Once the applet finishes running successfully, [[#ILibraryAppletAccessor]] PopOutData can be used to get the applet-specific [[#IStorage]] containing the applet output data.
   −
= LibraryAppletInfo =
+
== CommonArguments ==
−
{| class="wikitable" border="1"
+
The first [[#CreateStorage|IStorage]] passed to applets should contain the common library applet arguments. This is populated by <code>nn::la::CommonArgumentsWriter</code> and has the following format.
−
|-
  −
! Offset || Size || Description
  −
|-
  −
| 0x0 || 0x4 || [[#AppletId]]
  −
|-
  −
| 0x4 || 0x4 || [[#LibraryAppletMode]]
  −
|}
     −
This is "nn::am::service::LibraryAppletInfo". This struct is 0x8-bytes.
+
This struct is 0x20-bytes.
   −
= AppletKind =
+
Official sw handles the first 8-bytes separately, which is a header. With CommonArguments version 0x0, the header is 4-bytes, while starting with version 0x1 it's 8-bytes.
−
This is "nn::am::service::AppletKind". This is 8-bytes.
     −
= AppletIdentityInfo =
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Offset || Size || Description
+
! Offset || Size || Typical Value || Notes
 
|-
 
|-
−
| 0x0 || 0x4 || [[#AppletId]]
+
| 0x0 || 4 || 1 || Common Arguments version
 
|-
 
|-
−
| 0x4 || 0x4 || Padding
+
| 0x4 || 4 || 0x20 || Common Arguments size
 
|-
 
|-
−
| 0x8 || 0x8 || titleID
+
| 0x8 || 4 || || Library applet version (API version)
 +
|-
 +
| 0xC || 4 || 0 || Theme color
 +
|-
 +
| 0x10 || 1 || 0 || Play startup sound
 +
|-
 +
| 0x18 || 8 || N/A || System tick (see [[SVC#svcGetSystemTick|svcGetSystemTick]])
 +
|-
 +
|}
 +
 
 +
= AppletId =
 +
This is "nn::applet::AppletId". See also [[:Category:Library Applets]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! ProgramId
 +
! Description
 +
|-
 +
| 0x00
 +
|
 +
| None
 +
|-
 +
| 0x01
 +
|
 +
| Application (not valid for use with LibraryApplets)
 +
|-
 +
| 0x02
 +
| 010000000000100C
 +
| OverlayApplet (overlayDisp)
 +
|-
 +
| 0x03
 +
| 0100000000001000
 +
| SystemAppletMenu (qlaunch)
 +
|-
 +
| 0x04
 +
| 0100000000001012
 +
| SystemApplication (starter)
 +
|-
 +
| 0x0A
 +
| 0100000000001001
 +
| [[Auth_Applet|LibraryAppletAuth (auth)]]
 +
|-
 +
| 0x0B
 +
| 0100000000001002
 +
| [[Cabinet_Applet|LibraryAppletCabinet (cabinet)]]
 +
|-
 +
| 0x0C
 +
| 0100000000001003
 +
| [[Controller_Applet|LibraryAppletController (controller)]]
 +
|-
 +
| 0x0D
 +
| 0100000000001004
 +
| LibraryAppletDataErase (dataErase)
 +
|-
 +
| 0x0E
 +
| 0100000000001005
 +
| [[Error_Applet|LibraryAppletError (error)]]
 +
|-
 +
| 0x0F
 +
| 0100000000001006
 +
| LibraryAppletNetConnect (netConnect)
 +
|-
 +
| 0x10
 +
| 0100000000001007
 +
| [[Profile_Selector|LibraryAppletPlayerSelect (playerSelect)]]
 +
|-
 +
| 0x11
 +
| 0100000000001008
 +
| [[Software_Keyboard|LibraryAppletSwkbd (swkbd)]]
 +
|-
 +
| 0x12
 +
| 0100000000001009
 +
| [[MiiEdit_Applet|LibraryAppletMiiEdit (miiEdit)]]
 +
|-
 +
| 0x13
 +
| 010000000000100A
 +
| [[Internet_Browser#010000000000100A|LibraryAppletWeb (web)]]
 +
|-
 +
| 0x14
 +
| 010000000000100B
 +
| [[Internet_Browser#ShopN|LibraryAppletShop (shop)]]
 +
|-
 +
| 0x15
 +
| 010000000000100D
 +
| [[Album_Applet|LibraryAppletPhotoViewer (photoViewer)]]
 +
|-
 +
| 0x16
 +
| 010000000000100E
 +
| LibraryAppletSet (set)
 +
|-
 +
| 0x17
 +
| 010000000000100F
 +
| [[Internet_Browser#Offline_Applet|LibraryAppletOfflineWeb (offlineWeb)]]
 +
|-
 +
| 0x18
 +
| 0100000000001010
 +
| [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]]
 +
|-
 +
| 0x19
 +
| 0100000000001011
 +
| [[Internet_Browser#WifiWebAuthApplet|LibraryAppletWifiWebAuth (wifiWebAuth)]]
 +
|-
 +
| 0x1A
 +
| 0100000000001013
 +
| [[MyPage_Applet|LibraryAppletMyPage (myPage)]]
 +
|-
 +
| 0x1B
 +
| 010000000000101A
 +
| LibraryAppletGift (gift)
 +
|-
 +
| 0x1C
 +
| 010000000000101C
 +
| LibraryAppletUserMigration (userMigration)
 +
|-
 +
| 0x1D
 +
| 010000000000101D
 +
| [9.0.0+] LibraryAppletPreomiaSys (EncounterSys)
 +
|-
 +
| 0x1E
 +
| 0100000000001020
 +
| [9.0.0+] LibraryAppletStory (story)
 +
|-
 +
| 0x1F
 +
| 010070000E3C0000
 +
| [9.0.0+] LibraryAppletPreomiaUsr (EncounterUsr)
 +
|-
 +
| 0x20
 +
| 010086000E49C000
 +
| [9.0.0+] LibraryAppletPreomiaUsrDummy (EncounterUsrDummy)
 +
|-
 +
| 0x21
 +
| 0100000000001038
 +
| [10.0.0+] LibraryAppletSample (sample)
 +
|-
 +
| 0x22
 +
| 0100000000001007
 +
| [13.0.0+] LibraryAppletPromoteQualification (playerSelect)
 +
|-
 +
| 0x32
 +
| 010000000000100F
 +
| [17.0.0+] [[Internet_Browser#Offline_Applet|LibraryAppletOfflineWeb (offlineWeb)]]
 +
|-
 +
| 0x33
 +
| 010000000000100F
 +
| [17.0.0+] [[Internet_Browser#Offline_Applet|LibraryAppletOfflineWeb (offlineWeb)]]
 +
|-
 +
| 0x35
 +
| [17.0.0+] 0100000000001010 ([16.0.0-16.1.0] 0100000000001042)
 +
| [17.0.0+] [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] ([16.0.0-16.1.0] )
 +
|-
 +
| 0x36
 +
| [17.0.0+] 0100000000001010 ([16.0.0-16.1.0] 0100000000001042)
 +
| [17.0.0+] [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] ([16.0.0-16.1.0] )
 +
|-
 +
| 0x37
 +
| [17.0.0+] 0100000000001010 ([16.0.0-16.1.0] 0100000000001042)
 +
| [17.0.0+] [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] ([16.0.0-16.1.0] )
 +
|-
 +
| 0x38
 +
| 0100000000001043
 +
| [16.0.0-16.1.0]
 +
|-
 +
| 0x3E8
 +
|
 +
| [10.0.0-16.1.0] DevlopmentTool
 +
|-
 +
| 0x3F1
 +
| 010000000000D619
 +
| [10.0.0-16.1.0] CombinationLA
 +
|-
 +
| 0x3F2
 +
| 010000000000D610
 +
| [10.0.0-16.1.0] AeSystemApplet
 +
|-
 +
| 0x3F3
 +
| 010000000000D611
 +
| [10.0.0-16.1.0] AeOverlayApplet
 +
|-
 +
| 0x3F4
 +
| 010000000000D612
 +
| [10.0.0-16.1.0] AeStarter
 +
|-
 +
| 0x3F5
 +
| 010000000000D613
 +
| [10.0.0-16.1.0] AeLibraryAppletAlone
 +
|-
 +
| 0x3F6
 +
| 010000000000D614
 +
| [10.0.0-16.1.0] AeLibraryApplet1
 +
|-
 +
| 0x3F7
 +
| 010000000000D615
 +
| [10.0.0-16.1.0] AeLibraryApplet2
 +
|-
 +
| 0x3F8
 +
| 010000000000D616
 +
| [10.0.0-16.1.0] AeLibraryApplet3
 +
|-
 +
| 0x3F9
 +
| 010000000000D617
 +
| [10.0.0-16.1.0] AeLibraryApplet4
 +
|-
 +
| 0x3FA
 +
| 010000000000D60A
 +
| [10.0.0-16.1.0] AppletISA
 +
|-
 +
| 0x3FB
 +
| 010000000000D60B
 +
| [10.0.0-16.1.0] AppletIOA
 +
|-
 +
| 0x3FC
 +
| 010000000000D60C
 +
| [10.0.0-16.1.0] AppletISTA
 +
|-
 +
| 0x3FD
 +
| 010000000000D60D
 +
| [10.0.0-16.1.0] AppletILA1
 +
|-
 +
| 0x3FE
 +
| 010000000000D60E
 +
| [10.0.0-16.1.0] AppletILA2
 +
|-
 +
| 0x700000DC
 +
| 010000000000D619
 +
| [17.0.0+] CombinationLA
 +
|-
 +
| 0x700000E6
 +
| 010000000000D610
 +
| [17.0.0+] AeSystemApplet
 +
|-
 +
| 0x700000E7
 +
| 010000000000D611
 +
| [17.0.0+] AeOverlayApplet
 +
|-
 +
| 0x700000E8
 +
| 010000000000D612
 +
| [17.0.0+] AeStarter
 +
|-
 +
| 0x700000E9
 +
| 010000000000D613
 +
| [17.0.0+] AeLibraryAppletAlone
 +
|-
 +
| 0x700000EA
 +
| 010000000000D614
 +
| [17.0.0+] AeLibraryApplet1
 +
|-
 +
| 0x700000EB
 +
| 010000000000D615
 +
| [17.0.0+] AeLibraryApplet2
 +
|-
 +
| 0x700000EC
 +
| 010000000000D616
 +
| [17.0.0+] AeLibraryApplet3
 +
|-
 +
| 0x700000ED
 +
| 010000000000D617
 +
| [17.0.0+] AeLibraryApplet4
 +
|-
 +
| 0x700000F0
 +
| 010000000000D60A
 +
| [17.0.0+] AppletISA
 +
|-
 +
| 0x700000F1
 +
| 010000000000D60B
 +
| [17.0.0+] AppletIOA
 +
|-
 +
| 0x700000F2
 +
| 010000000000D60C
 +
| [17.0.0+] AppletISTA
 +
|-
 +
| 0x700000F3
 +
| 010000000000D60D
 +
| [17.0.0+] AppletILA1
 +
|-
 +
| 0x700000F4
 +
| 010000000000D60E
 +
| [17.0.0+] AppletILA2
 +
|}
 +
 
 +
= LibraryAppletMode =
 +
This is "nn::applet::LibraryAppletMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0x0
 +
| AllForeground
 +
|-
 +
| 0x1
 +
| PartialForeground
 +
|-
 +
| 0x2
 +
| NoUi
 +
|-
 +
| 0x3
 +
| PartialForegroundWithIndirectDisplay (see also [[#GetIndirectLayerConsumerHandle]], only used by swkbd [[Software_Keyboard|InlineKeyboard]])
 +
|-
 +
| 0x4
 +
| AllForegroundInitiallyHidden (can be used by [7.0.0+] [[Internet_Browser|WebSession]])
 +
|}
 +
 
 +
= AppletMessage =
 +
This is "nn::am::AppletMessage".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || None
 +
|-
 +
| 1 || ChangeIntoForeground
 +
|-
 +
| 2 || ChangeIntoBackground
 +
|-
 +
| 4 || Exit
 +
|-
 +
| 6 || ApplicationExited
 +
|-
 +
| 7 ||
 +
|-
 +
| 15 || [[#FocusState|FocusStateChanged]]
 +
|-
 +
| 16 || [[#SetRestartMessageEnabled|Resume]]
 +
|-
 +
| 20 || DetectShortPressingHomeButton
 +
|-
 +
| 21 || DetectLongPressingHomeButton
 +
|-
 +
| 22 || DetectShortPressingPowerButton
 +
|-
 +
| 23 || DetectMiddlePressingPowerButton
 +
|-
 +
| 24 || DetectLongPressingPowerButton
 +
|-
 +
| 25 || RequestToPrepareSleep
 +
|-
 +
| 26 || FinishedSleepSequence
 +
|-
 +
| 27 || SleepRequiredByHighTemperature
 +
|-
 +
| 28 || SleepRequiredByLowBattery
 +
|-
 +
| 29 || AutoPowerDown
 +
|-
 +
| 30 || [[#OperationMode|OperationModeChanged]]
 +
|-
 +
| 31 || [[#PerformanceMode|PerformanceModeChanged]]
 +
|-
 +
| 32 || DetectReceivingCecSystemStandby
 +
|-
 +
| 33 || SdCardRemoved
 +
|-
 +
| 34 ||
 +
|-
 +
| 50 || LaunchApplicationRequested
 +
|-
 +
| 51 || [[#SetHandlesRequestToDisplay|RequestToDisplay]]
 +
|-
 +
| 55 || ShowApplicationLogo
 +
|-
 +
| 56 || HideApplicationLogo
 +
|-
 +
| 57 || ForceHideApplicationLogo
 +
|-
 +
| 58 ||
 +
|-
 +
| 59 ||
 +
|-
 +
| 60 || FloatingApplicationDetected
 +
|-
 +
| 61 || [7.0.0+] PerformanceConfigurationChanged
 +
|-
 +
| 70 ||
 +
|-
 +
| 71 ||
 +
|-
 +
| 72 ||
 +
|-
 +
| 73 ||
 +
|-
 +
| 75 ||
 +
|-
 +
| 80 ||
 +
|-
 +
| 81 ||
 +
|-
 +
| 82 ||
 +
|-
 +
| 83 ||
 +
|-
 +
| 85 ||
 +
|-
 +
| 86 ||
 +
|-
 +
| 90 || [[#SetRequiresCaptureButtonShortPressedMessage|DetectShortPressingCaptureButton]]
 +
|-
 +
| 92 || [[#SetAlbumImageTakenNotificationEnabled|AlbumScreenShotTaken]]
 +
|-
 +
| 93 || AlbumRecordingSaved
 +
|-
 +
| 94 ||
 +
|-
 +
| 100 ||
 +
|-
 +
| 101 ||
 +
|-
 +
| 110 || [14.0.0+] DetectShortPressingCaptureButtonForApplet
 +
|-
 +
| 111 || [14.0.0+] DetectLongPressingCaptureButtonForApplet
 +
|-
 +
| 1000 ||
 +
|}
 +
 
 +
= OperationMode =
 +
This is "nn::oe::OperationMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Handheld
 +
|-
 +
| 1 || Console
 +
|}
 +
 
 +
= PerformanceMode =
 +
This is "nn::oe::PerformanceMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| -1 || Invalid
 +
|-
 +
| 0 || Normal
 +
|-
 +
| 1 || Boost
 +
|}
 +
 
 +
= FocusState =
 +
This is "nn::oe::FocusState".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 1 || InFocus
 +
|-
 +
| 2 || OutOfFocus
 +
|-
 +
| 3 || Background
 +
|}
 +
 
 +
= CpuBoostMode =
 +
This is "nn::oe::CpuBoostMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Normal
 +
|-
 +
| 1 || FastLoad
 +
|}
 +
 
 +
= WindowOriginMode =
 +
This is "nn::oe::WindowOriginMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || LowerLeft
 +
|-
 +
| 1 || UpperLeft
 +
|}
 +
 
 +
= WirelessPriorityMode =
 +
This is "nn::oe::WirelessPriorityMode".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Default
 +
|-
 +
| 1 || OptimizedForWlan
 +
|}
 +
 
 +
= TvPowerStateMatchingMode =
 +
This is "nn::oe::TvPowerStateMatchingMode". This is used with [[#SetTvPowerStateMatchingMode]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Unknown
 +
|-
 +
| 1 || Unknown
 +
|}
 +
 
 +
= SystemButtonType =
 +
This is "nn::am::service::SystemButtonType". This is used with [[#PerformSystemButtonPressingIfInFocus]]/[[#PerformSystemButtonPressing]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 1 || PerformHomeButtonShortPressing
 +
|-
 +
| 2 || PerformHomeButtonLongPressing
 +
|-
 +
| 3 || Short-pressing with the Power-button. Only available with [[#PerformSystemButtonPressing]].
 +
|-
 +
| 4 || Long-pressing with the Power-button. Only available with [[#PerformSystemButtonPressing]].
 +
|-
 +
| 5 || Shutdown the system. Only available with [[#PerformSystemButtonPressing]].
 +
|-
 +
| 6 || PerformCaptureButtonShortPressing
 +
|-
 +
| 7 || PerformCaptureButtonLongPressing
 +
|}
 +
 
 +
= LaunchParameterKind =
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 1 || UserChannel. Application-specific LaunchParameter.
 +
|-
 +
| 2 || account PreselectedUser
 +
|-
 +
| 3 || Unknown if used by anything?
 +
|}
 +
 
 +
= LibraryAppletExitReason =
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Normal
 +
|-
 +
| 1 || Canceled
 +
|-
 +
| 2 || Abnormal
 +
|-
 +
| 10 || Unexpected
 +
|}
 +
 
 +
= ProgramSpecifyKind =
 +
This is "nn::am::service::ProgramSpecifyKind". This controls the type of the u64 passed to [[#ExecuteProgram]].
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || u8 ProgramIndex. "ExecuteProgram". [[NS_Services|NS]] handles ProgramIndex by launching ApplicationId+ProgramIndex. After using [[#ExecuteProgram]] with this successfully, official user-processes will enter an infinite loop with sleep-thread value 86400000000000.
 +
|-
 +
| 1 || [[NCM_services#ApplicationId|ApplicationId]]. "JumpToSubApplicationProgramForDevelopment". Only available when [[Settings_services#GetDebugModeFlag|DebugMode]] is 1.
 +
|-
 +
| 2 || u64 = value 0. "RestartProgram"
 +
|}
 +
 
 +
ProgramIndex values where the title is not installed should not be used: [[qlaunch]] will display an error message and the current title will become "corrupted", however Home Menu will have an option to repair it.
 +
 
 +
= InputDetectionPolicy =
 +
This is u32 enum "nn::applet::InputDetectionPolicy".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Value
 +
! Description
 +
|-
 +
| 0 || Unknown
 +
|-
 +
| 1 || Unknown
 +
|}
 +
 
 +
= AppletResourceUserId =
 +
This is "nn::applet::AppletResourceUserId". Used by a number of non-AM services.
 +
 
 +
= AppletAttribute =
 +
This is "nn::am::AppletAttribute". This struct is 0x80 bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || Flag. When non-zero, two state fields are set to 1.
 +
|-
 +
| 0x1 || 0x7F || Unused
 +
|}
 +
 
 +
This is used by [[#OpenLibraryAppletProxy]].
 +
 
 +
= AppletProcessLaunchReason =
 +
This is "nn::am::service::AppletProcessLaunchReason". This struct is 0x4-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x1 || Flag. When non-zero, LibraryApplets then use [[#OpenCallingLibraryApplet]].
 +
|-
 +
| 0x1 || 0x2 || Always 0.
 +
|-
 +
| 0x3 || 0x1 || Always 0.
 +
|}
 +
 
 +
= LibraryAppletInfo =
 +
This is "nn::am::service::LibraryAppletInfo". This struct is 0x8-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#AppletId]]
 +
|-
 +
| 0x4 || 0x4 || [[#LibraryAppletMode]]
 +
|}
 +
 
 +
= AppletKind =
 +
This is "nn::am::service::AppletKind". This is 8-bytes.
 +
 
 +
= AppletIdentityInfo =
 +
This struct is "nn::am::service::AppletIdentityInfo". This struct is 0x10-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || [[#AppletId]]
 +
|-
 +
| 0x4 || 0x4 || Padding
 +
|-
 +
| 0x8 || 0x8 || [[NCM_services#ApplicationId|ApplicationId]]
 +
|}
 +
 
 +
= ApplicationAttributeForQuest =
 +
This struct is "nn::applet::ApplicationAttributeForQuest".
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || See [[#ApplicationAttribute]].
 +
|-
 +
| 0x4 || 0x4 || See [[#ApplicationAttribute]].
 +
|-
 +
| 0x8 || 0x4 || [7.0.0+] See [[#ApplicationAttribute]].
 +
|}
 +
 
 +
User-processes copy the first 0x8-bytes (0xC-bytes with [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]]/[[#CreateApplicationWithAttributeAndRequestToStartForQuest]]) to a [[#ApplicationAttribute]] with the rest of the struct being cleared, which is then passed to the actual cmd (CreateApplication*ToStartForQuest).
 +
 
 +
= ApplicationAttribute =
 +
This struct is "nn::am::ApplicationAttribute". This struct is 0x20-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || Default is 0 for non-Quest. Only used when non-zero: unknown value in seconds.
 +
|-
 +
| 0x4 || 0x4 || Default is 0 for non-Quest. Only used when non-zero: unknown value in seconds.
 +
|-
 +
| 0x8 || 0x4 || float audio volume. Must be in the range of 0.0f-1.0f. The default is 1.0f.
 +
|-
 +
| 0xC || 0x14 || Unused. Default is 0.
 +
|}
 +
 
 +
Internally AM only uses the first 0xC-bytes from ApplicationAttribute, regardless of the cmd.
 +
 
 +
= ApplicationLaunchProperty =
 +
This struct is 0x10-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x8 || [[NCM_services#ApplicationId|ApplicationId]]
 +
|-
 +
| 0x8 || 0x4 || Application title-version.
 +
|-
 +
| 0xC || 0x1 || [[Filesystem_services#StorageId|StorageId]] for the Application base title.
 +
|-
 +
| 0xD || 0x1 || [[Filesystem_services#StorageId|StorageId]] for the Application update title.
 +
|-
 +
| 0xE || 0x1 || Unknown.
 +
|-
 +
| 0xF || 0x1 || Padding.
 +
|}
 +
 
 +
= ApplicationLaunchRequestInfo =
 +
This is "nn::applet::ApplicationLaunchRequestInfo". This struct is 0x10-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || Unknown. The default is 0x0 with [[#CreateSystemApplication]], 0x3 with [[#CreateApplication]].
 +
|-
 +
| 0x4 || 0x4 || Unknown. The default is 0x0 with [[#CreateSystemApplication]], 0x3 with [[#CreateApplication]].
 +
|-
 +
| 0x8 || 0x8 || Unknown. The default is 0x0.
 +
|}
 +
 
 +
= AppletResourceUsageInfo =
 +
This is "nn::am::service::AppletResourceUsageInfo". This struct is 0x20-bytes.
 +
 
 +
{| class="wikitable" border="1"
 +
|-
 +
! Offset || Size || Description
 +
|-
 +
| 0x0 || 0x4 || Unknown counter.
 +
|-
 +
| 0x4 || 0x4 || Unknown counter.
 +
|-
 +
| 0x8 || 0x4 || Output from [[NS_Services|NS GetRightsEnvironmentCountForDebug]].
 +
|-
 +
| 0xC || 0x14 || Always zero.
 
|}
 
|}
   −
This struct is "nn::am::service::AppletIdentityInfo". This struct is 0x10-bytes.
+
= ApplicationLicenseType =
−
 
+
This is "nn::oe::ApplicationLicenseType". This is 1-byte.
−
= ApplicationAttributeForQuest =
  −
{| class="wikitable" border="1"
  −
|-
  −
! Offset || Size || Description
  −
|-
  −
| 0x0 || 0x4 || See [[#ApplicationAttribute]].
  −
|-
  −
| 0x4 || 0x4 || See [[#ApplicationAttribute]].
  −
|-
  −
| 0x8 || 0x4 || [7.0.0+] See [[#ApplicationAttribute]].
  −
|}
     −
This struct is "nn::applet::ApplicationAttributeForQuest".
+
= LaunchRequiredVersion =
 +
This is "nn::oe::LaunchRequiredVersion". This is a 0x40-byte struct with 1-byte alignment.
   −
User-processes copy the first 0x8-bytes (0xC-bytes with [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]]/[[#CreateApplicationWithAttributeAndRequestToStartForQuest]]) to a [[#ApplicationAttribute]] with the rest of the struct being cleared, which is then passed to the actual cmd (CreateApplication*ToStartForQuest).
+
= ServerEnvironmentType =
 +
This is "nn::oe::ServerEnvironmentType".
   −
= ApplicationAttribute =
   
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Offset || Size || Description
+
! Value
 +
! Description
 +
|-
 +
| 0 || dd
 
|-
 
|-
−
| 0x0 || 0x4 || Default is 0 for non-Quest. Only used when non-zero: unknown value in seconds.
+
| 1 || lp
 
|-
 
|-
−
| 0x4 || 0x4 || Default is 0 for non-Quest. Only used when non-zero: unknown value in seconds.
+
| 2 || sd
 
|-
 
|-
−
| 0x8 || 0x4 || float audio volume. Must be in the range of 0.0f-1.0f. The default is 1.0f.
+
| 3 || sp
 
|-
 
|-
−
| 0xC || 0x14 || Unused. Default is 0.
+
| 4 || dp
 
|}
 
|}
   −
This struct is "nn::am::ApplicationAttribute". This struct is 0x20-bytes.
+
= Notes =
−
 
+
AM-sysmodule will only initialize [[Shared_Database_services|pdm:ntfy]] / use pdm:ntfy service commands when the value from [[Process_Manager_services|pm:bm]] GetBootMode is not 0x1 (Maintenance).
−
Internally AM only uses the first 0xC-bytes from ApplicationAttribute, regardless of the cmd.
  −
 
  −
= ApplicationLaunchProperty =
  −
{| class="wikitable" border="1"
  −
|-
  −
! Offset || Size || Description
  −
|-
  −
| 0x0 || 0x8 || Application titleID.
  −
|-
  −
| 0x8 || 0x4 || Application title-version.
  −
|-
  −
| 0xC || 0x1 || [[Filesystem_services#StorageId|StorageId]] for the Application base title.
  −
|-
  −
| 0xD || 0x1 || [[Filesystem_services#StorageId|StorageId]] for the Application update title.
  −
|-
  −
| 0xE || 0x1 || Unknown.
  −
|-
  −
| 0xF || 0x1 || Padding.
  −
|}
  −
 
  −
This struct is 0x10-bytes.
  −
 
  −
= ApplicationLaunchRequestInfo =
  −
{| class="wikitable" border="1"
  −
|-
  −
! Offset || Size || Description
  −
|-
  −
| 0x0 || 0x4 || Unknown. The default is 0x0 with [[#CreateSystemApplication]], 0x3 with [[#CreateApplication]].
  −
|-
  −
| 0x4 || 0x4 || Unknown. The default is 0x0 with [[#CreateSystemApplication]], 0x3 with [[#CreateApplication]].
  −
|-
  −
| 0x8 || 0x8 || Unknown. The default is 0x0.
  −
|}
     −
This struct is "nn::applet::ApplicationLaunchRequestInfo". This struct is 0x10-bytes.
+
An object constructor also writes the output from [[Process_Manager_services|pm:bm]] GetBootMode into the created object. A vfunc for this object checks whether this field is Maintenance: if so, it calls a vfunc then a func and returns. Otherwise after calling various (v)funcs, if required this eventually uses [[OMM_services|ommdisp]] cmd600.
−
 
  −
= AppletResourceUsageInfo =
  −
{| class="wikitable" border="1"
  −
|-
  −
! Offset || Size || Description
  −
|-
  −
| 0x0 || 0x4 || Unknown counter.
  −
|-
  −
| 0x4 || 0x4 || Unknown counter.
  −
|-
  −
| 0x8 || 0x4 || Output from [[NS_Services|NS GetRightsEnvironmentCountForDebug]].
  −
|-
  −
| 0xC || 0x14 || Always zero.
  −
|}
  −
 
  −
This struct is "nn::am::service::AppletResourceUsageInfo". This struct is 0x20-bytes.
  −
 
  −
= Notes =
  −
AM-sysmodule will only initialize [[Shared_Database_services|pdm:ntfy]] / use pdm:ntfy service commands when the value from [[Process_Manager_services|pm:bm]] GetBootMode is not 0x1.
      
[[Category:Services]]
 
[[Category:Services]]
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/7488...12689"

Navigation menu