Nintendo Switch Brew

Applet Manager services: Difference between revisions

← Older edit
No edit summary
 
(31 intermediate revisions by 3 users not shown)
Line 19: Line 19:
|-
|-
| 300 || OpenOverlayAppletProxy || Returns an [[#IOverlayAppletProxy]].
| 300 || OpenOverlayAppletProxy || Returns an [[#IOverlayAppletProxy]].
|-
| 310 || [S2] || Returns an [[#ICMenuProxy|ICMenuProxy]].
|-
|-
| 350 || OpenSystemApplicationProxy || Returns an [[#IApplicationProxy]].
| 350 || OpenSystemApplicationProxy || Returns an [[#IApplicationProxy]].
Line 29: Line 31:
|-
|-
| 460 || [20.0.0+] || Returns an [[#IAppletAlternativeFunctions]].
| 460 || [20.0.0+] || Returns an [[#IAppletAlternativeFunctions]].
|-
| 500 || [S2] || Returns an [[#IChatProxy|IChatProxy]].
|-
|-
| 1000 || [6.0.0+] [[#GetDebugFunctions]] ||  
| 1000 || [6.0.0+] [[#GetDebugFunctions]] ||  
Line 276: Line 280:
|-
|-
| 30 || [12.0.0+] [[#OpenCradleFirmwareUpdater]]
| 30 || [12.0.0+] [[#OpenCradleFirmwareUpdater]]
|-
| 100 || [S2]
|}
|}


Line 334: Line 340:
==== OpenCradleFirmwareUpdater ====
==== OpenCradleFirmwareUpdater ====
No input, returns an [[#ICradleFirmwareUpdater]].
No input, returns an [[#ICradleFirmwareUpdater]].
==== Cmd100 ====
No input, returns an output handle.


=== ICradleFirmwareUpdater ===
=== ICradleFirmwareUpdater ===
Line 632: Line 641:
|-
|-
| 100 || [15.0.0+] SetApplicationCoreUsageMode
| 100 || [15.0.0+] SetApplicationCoreUsageMode
|-
| 110 || [S2]
|-
| 111 || [S2]
|-
| 112 || [S2]
|-
| 113 || [S2]
|-
| 114 || [S2]
|-
| 115 || [S2]
|-
| 116 || [S2]
|-
| 117 || [S2]
|-
| 118 || [S2]
|-
| 119 || [S2]
|-
| 120 || [S2]
|-
| 121 || [S2]
|-
| 122 || [S2]
|-
| 123 || [S2]
|-
| 124 || [S2]
|-
| 130 || [S2]
|-
| 131 || [S2] [20.0.0+]
|-
| 135 || [S2] [20.0.0+]
|-
| 140 || [S2]
|-
| 150 || [S2]
|-
|-
| 160 || [18.0.0+] [[#GetNotificationReceiverService|GetNotificationReceiverService]]
| 160 || [18.0.0+] [[#GetNotificationReceiverService|GetNotificationReceiverService]]
Line 637: Line 686:
| 161 || [18.0.0+] [[#GetNotificationSenderService|GetNotificationSenderService]]
| 161 || [18.0.0+] [[#GetNotificationSenderService|GetNotificationSenderService]]
|-
|-
| 300 || [17.0.0+] GetCurrentApplicationId
| 170 || [S2]
|-
| 171 || [S2]
|-
| 200 || [S2]
|-
| 210 || [S2]
|-
|-
| 310 || [19.0.0+] IsSystemAppletHomeMenu
| 211 || [S2]
|-
|-
| 311 || [20.0.0+]
| 220 || [S2]
|-
|-
| 320 || [19.0.0+] SetGpuTimeSliceBoost
| 221 || [S2]
|-
|-
| 321 || [19.0.0+] SetGpuTimeSliceBoostDueToApplication
| 230 || [S2]
|-
|-
| 322 || [20.0.0+]
| 231 || [S2]
|-
|-
| 330 || [19.0.0+]  
| 250 || [S2]
|-
|-
| 340 || [20.0.0+]
| 251 || [S2]
|-
|-
| 341 || [20.0.0+]
| 252 || [S2]
|-
|-
| 342 || [20.0.0+]
| 253 || [S2]
|-
|-
| 350 || [20.0.0+]
| 260 || [S2]
|-
|-
| 360 || [20.0.0+]
| 271 || [S2] [20.0.0+]
|-
|-
| 370 || [22.0.0+]
| 280 || [S2] [20.0.0+]
|}
|-
 
| 290 || [S2] [20.0.0+] RequestChatProhibition
|-
| 291 || [S2] [20.0.0+] RequestChatExpirationCheckSkip
|-
| 300 || [17.0.0+] GetCurrentApplicationId
|-
| 310 || [19.0.0+] IsSystemAppletHomeMenu
|-
| 311 || [20.0.0+]
|-
| 320 || [19.0.0+] SetGpuTimeSliceBoost
|-
| 321 || [19.0.0+] SetGpuTimeSliceBoostDueToApplication
|-
| 322 || [20.0.0+]
|-
| 330 || [19.0.0+]
|-
| 340 || [20.0.0+]
|-
| 341 || [20.0.0+]
|-
| 342 || [20.0.0+]
|-
| 350 || [20.0.0+]
|-
| 360 || [20.0.0+]
|-
| 370 || [22.0.0+] GetGpuErrorEventForApplet
|-
| 2000 || [S2]
|-
| 2010 || [S2]
|-
| 3000 || [S2] [20.0.0+]
|-
| 3010 || [S2] [20.0.0+]
|}
 
ReadThemeStorage/WriteThemeStorage: these commands copy data from/to a state buffer and the user specified buffer. The size of the state buffer is 0x400-bytes. The default content of the ThemeStorage prior to using the WriteThemeStorage cmd, is: <code>memset(statebuf, 0xAA, 0x400);</code>
ReadThemeStorage/WriteThemeStorage: these commands copy data from/to a state buffer and the user specified buffer. The size of the state buffer is 0x400-bytes. The default content of the ThemeStorage prior to using the WriteThemeStorage cmd, is: <code>memset(statebuf, 0xAA, 0x400);</code>


Line 737: Line 830:
! Cmd || Name
! Cmd || Name
|-
|-
| 0 ||  
| 0 || AddSource
|-
|-
| 1 ||  
| 1 || RemoveSource
|-
|-
| 2 ||  
| 2 || GetEvent
|-
|-
| 3 ||  
| 3 || Receive
|-
|-
| 4 ||  
| 4 || ReceiveWithTick
|}
|}


=== ISenderService ===
===== GetEvent =====
Unofficial name.
 
No input, returns an Event handle.
 
===== ReceiveWithTick =====
Unofficial name.
 
=== ISenderService ===
This is "nn::am::service::ISenderService".
This is "nn::am::service::ISenderService".


Line 772: Line 873:
! Cmd || Name
! Cmd || Name
|-
|-
| 0 ||  
| 0 || Send
|-
|-
| 1 ||  
| 1 || GetUnreceivedMessageCount
|}
|}


Line 1,093: Line 1,194:
|-
|-
| 60 || [19.0.0+]  
| 60 || [19.0.0+]  
|-
| 61 || [S2]
|-
|-
| 70 || [21.0.0+]  
| 70 || [21.0.0+]  
Line 1,103: Line 1,206:
|-
|-
| 101 || [5.0.0+] [[#BeginToObserveHidInputForDevelop]]
| 101 || [5.0.0+] [[#BeginToObserveHidInputForDevelop]]
|-
| 110 || [S2]
|-
| 1000 || [S2]
|}
|}


Line 1,163: Line 1,270:
Enables HID input for the OverlayApplet, without disabling input for the foreground applet.
Enables HID input for the OverlayApplet, without disabling input for the foreground applet.


== IApplicationProxy ==
== ICMenuProxy ==
This is "nn::am::service::IApplicationProxy".
This is "nn::am::service::ICMenuProxy".
 
This is exclusive to Switch 2.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 1,179: Line 1,288:
|-
|-
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|-
|-
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
Line 1,184: Line 1,295:
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
|-
| 20 || GetApplicationFunctions || Returns an [[#IApplicationFunctions]].
| 20 || GetOverlayFunctions || Returns an [[#IOverlayFunctions]].
|-
| 21 || GetAppletCommonFunctions || No input, returns an [[#IAppletCommonFunctions]].
|-
| 23 || GetGlobalStateController || No input, returns an [[#IGlobalStateController]].
|-
|-
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
| 24 || || No input, returns an [[#ICMenuFunctions|ICMenuFunctions]].
|}
|}


=== IApplicationFunctions ===
=== ICMenuFunctions ===
This is "nn::am::service::IApplicationFunctions".
This is "nn::am::service::ICMenuFunctions".
 
This is exclusive to Switch 2.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 1,196: Line 1,313:
! Cmd || Name
! Cmd || Name
|-
|-
| 1 || [[#PopLaunchParameter]]
| 0 ||  
|-
|-
| 10 || [[#CreateApplicationAndPushAndRequestToStart]]
| 1 ||  
|-
|-
| 11 || [3.0.0+] [[#CreateApplicationAndPushAndRequestToStartForQuest]]
| 2 ||  
|-
|-
| 12 || [4.0.0+] [[#CreateApplicationAndRequestToStart]]
| 3 ||  
|-
|-
| 13 || [4.0.0+] [[#CreateApplicationAndRequestToStartForQuest]]
| 4 ||  
|-
|-
| 14 || [7.0.0+] [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]]
| 5 ||  
|-
|-
| 15 || [7.0.0+] [[#CreateApplicationWithAttributeAndRequestToStartForQuest]]
| 6 ||  
|-
|-
| 20 || [[#EnsureSaveData]]
| 10 ||  
|-
|-
| 21 || [[#GetDesiredLanguage]]
| 11 ||  
|-
|-
| 22 || [[#SetTerminateResult]]
| 20 ||  
|-
|-
| 23 || [[#GetDisplayVersion]]
| 21 ||  
|-
|-
| 24 || [2.0.0+] [[#GetLaunchStorageInfoForDebug]]
| 30 ||  
|-
|-
| 25 || [3.0.0+] ExtendSaveData
| 31 ||  
|-
|-
| 26 || [3.0.0+] GetSaveDataSize
| 40 ||  
|-
|-
| 27 || [5.0.0+] CreateCacheStorage
| 41 ||  
|-
|-
| 28 || [11.0.0+] [[#GetSaveDataSizeMax]]
| 50 ||  
|-
|-
| 29 || [11.0.0+] [[#GetCacheStorageMax]]
| 60 ||  
|-
|-
| 30 || [[#BeginBlockingHomeButtonShortAndLongPressed]]
| 61 ||  
|-
|-
| 31 || [[#EndBlockingHomeButtonShortAndLongPressed]]
| 90 ||  
|-
|-
| 32 || [[#BeginBlockingHomeButton]]
| 101 ||  
|-
|-
| 33 || [[#EndBlockingHomeButton]]
| 110 ||  
|-
|-
| 34 || [10.0.0-15.0.1] [[#SelectApplicationLicense]]
| 1000 ||  
|-
|-
| 35 || [11.0.0+] [[#GetDeviceSaveDataSizeMax]]
| 200 ||  
|-
|-
| 36 || [14.0.0+] GetLimitedApplicationLicense
| 202 ||  
|-
|-
| 37 || [14.0.0+] GetLimitedApplicationLicenseUpgradableEvent
| 210 || [20.0.0+]
|-
|-
| 40 || [[#NotifyRunning]]
| 220 || [20.0.0+]
|}
 
==== Cmd200 ====
No input, returns an [[#ILibraryAppletAgent|ILibraryAppletAgent]].
 
==== Cmd202 ====
Takes {...}, returns an [[#IFocusableLayer|IFocusableLayer]].
 
==== ILibraryAppletAgent ====
This is "nn::am::service::ILibraryAppletAgent".
 
This is exclusive to Switch 2.
 
{| class="wikitable" border="1"
|-
|-
| 50 || [2.0.0+] [[#GetPseudoDeviceId]]
! Cmd || Name
|-
|-
| 60 || [2.0.0+] [[#SetMediaPlaybackStateForApplication]]
| 0 ||  
|-
|-
| 65 || [3.0.0+] [[#IsGamePlayRecordingSupported]]
| 1 ||  
|-
|-
| 66 || [3.0.0+] [[#InitializeGamePlayRecording]]
| 2 ||  
|-
|-
| 67 || [3.0.0+] [[#SetGamePlayRecordingState]]
| 3 ||  
|-
|-
| 68 || [4.0.0+] [[#RequestFlushGamePlayingMovieForDebug]]
| 4 ||  
|-
|-
| 70 || [3.0.0+] [[#RequestToShutdown]]
| 5 ||  
|-
|-
| 71 || [3.0.0+] [[#RequestToReboot]]
| 10 ||  
|-
|-
| 72 || [10.0.0+] [[#RequestToSleep]]
| 20 ||  
|-
|-
| 80 || [4.0.0+] [[#ExitAndRequestToShowThanksMessage]]
| 21 ||  
|-
|-
| 90 || [4.0.0+] [[#EnableApplicationCrashReport]]
| 31 ||  
|-
|-
| 100 || [5.0.0+] [[#InitializeApplicationCopyrightFrameBuffer]]
| 32 ||  
|-
|-
| 101 || [5.0.0+] [[#SetApplicationCopyrightImage]]
| 33 ||  
|-
|-
| 102 || [5.0.0+] [[#SetApplicationCopyrightVisibility]]
| 34 ||  
|-
|-
| 110 || [5.0.0+] [[#QueryApplicationPlayStatistics]]
| 35 ||  
|-
|-
| 111 || [6.0.0+] [[#QueryApplicationPlayStatisticsByUid]]
| 40 ||  
|-
|-
| 112 || [20.0.0+]
| 41 ||  
|-
|-
| 113 || [20.0.0+]
| 42 ||  
|}
 
===== Cmd0 =====
No input, returns an [[#IStorage|IStorage]].
 
===== Cmd1 =====
Takes an unknown input interface, no output.
 
===== Cmd2 =====
No input, returns an [[#IStorage|IStorage]].
 
===== Cmd3 =====
Takes an unknown input interface, no output.
 
===== Cmd10 =====
No input, returns an [[#IStorage|IStorage]].
 
===== Cmd20 =====
Takes an unknown input interface, no output.
 
===== Cmd21 =====
Takes an unknown input interface, no output.
 
==== IFocusableLayer ====
This is "nn::am::service::IFocusableLayer".
 
This is exclusive to Switch 2.
 
{| class="wikitable" border="1"
|-
|-
| 120 || [5.0.0+] [[#ExecuteProgram]]
! Cmd || Name
|-
|-
| 121 || [5.0.0+] [[#ClearUserChannel]]
| 0 ||  
|-
|-
| 122 || [5.0.0+] [[#UnpopToUserChannel]]
| 1 ||  
|-
|-
| 123 || [5.0.0+] [[#GetPreviousProgramIndex]]
| 2 ||  
|-
|-
| 124 || [6.0.0+] [[#EnableApplicationAllThreadDumpOnCrash]]
| 3 ||  
|-
|-
| 130 || [8.0.0+] [[#GetGpuErrorDetectedSystemEvent]]
| 4 ||  
|-
|-
| 131 || [11.0.0+] [[#SetDelayTimeToAbortOnGpuError]]
| 10 ||  
|-
|-
| 140 || [9.0.0+] [[#GetFriendInvitationStorageChannelEvent]]
| 11 ||  
|-
|-
| 141 || [9.0.0+] [[#TryPopFromFriendInvitationStorageChannel]]
| 20 ||  
|-
|-
| 150 || [9.0.0+] [[#GetNotificationStorageChannelEvent]]
| 21 ||  
|-
|-
| 151 || [9.0.0+] [[#TryPopFromNotificationStorageChannel]]
| 32 ||  
|-
|-
| 160 || [9.0.0+] [[#GetHealthWarningDisappearedSystemEvent]]
| 33 ||  
|-
|-
| 170 || [9.0.0+] [[#SetHdcpAuthenticationActivated]]
| 40 ||  
|-
|-
| 180 || [10.1.0+] [[#GetLaunchRequiredVersion]]
| 41 ||  
|-
|-
| 181 || [10.1.0+] [[#UpgradeLaunchRequiredVersion]]
| 42 ||  
|-
|-
| 190 || [11.0.0+] [[#SendServerMaintenanceOverlayNotification]]
| 50 || [20.0.0+]
|-
| 51 || [20.0.0+]
|-
| 60 || [20.0.0+]
|-
| 70 || [20.0.0+]
|-
| 71 || [20.0.0+]
|}
 
== IApplicationProxy ==
This is "nn::am::service::IApplicationProxy".
 
{| class="wikitable" border="1"
|-
! Cmd || Name || Notes
|-
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
|-
| 200 || [11.0.0+] [[#GetLastApplicationExitReason]]
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
|-
| 210 || [20.0.0+]
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
|-
| 220 || [20.0.0+] [[#SetAudioOutputPolicy|SetAudioOutputPolicy]]
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
|-
| 300 || [19.0.0+] [[#CreateMovieWriter]]
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
|-
| 310 || [20.0.0+] [[#RequestExitApplicationAndTryPopMessage|RequestExitApplicationAndTryPopMessage]]
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
|-
| 320 || [20.0.0+]
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
|-
| 330 || [20.2.0+] IsLanguageSelectionLimited
| 20 || GetApplicationFunctions || Returns an [[#IApplicationFunctions]].
|-
|-
| 500 || [5.0.0+] [[#StartContinuousRecordingFlushForDebug]]
| 40 || [S2] || Returns an [[#IPerformanceFunctions|IPerformanceFunctions]].
|-
|-
| 1000 || [5.0.0+] [[#CreateMovieMaker]]
| 60 || [S2] || Returns an [[#IGraphicsScalingParametersFunctions|IGraphicsScalingParametersFunctions]].
|-
|-
| 1001 || [5.0.0+] [[#PrepareForJit]]
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|}
|}


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):
=== IApplicationFunctions ===
* [[SVC|Creates]] TransferMemory using the input buffer and size, with permissions=0.
This is "nn::am::service::IApplicationFunctions".
* Uses [[#InitializeGamePlayRecording]] with the TransferMemory.
* Closes the TransferMemory handle, + TransferMemory cleanup.
* Uses [[#SetGamePlayRecordingState]] with value 0x1.
This GamePlayRecording functionality presumably enables the video-recording usable starting with [[4.0.0]].


==== PopLaunchParameter ====
{| class="wikitable" border="1"
Takes an input u32 [[#LaunchParameterKind]], returns an output [[#IStorage]].
|-
 
! Cmd || Name
Pops a LaunchParameter [[#IStorage]], the storage will be removed from sysmodule state during this.
|-
 
| 1 || [[#PopLaunchParameter]]
==== CreateApplicationAndPushAndRequestToStart ====
|-
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an input [[#IStorage]], no output. ApplicationId=0 can be used to relaunch the current application.
| 10 || [[#CreateApplicationAndPushAndRequestToStart]]
 
|-
==== CreateApplicationAndPushAndRequestToStartForQuest ====
| 11 || [3.0.0+] [[#CreateApplicationAndPushAndRequestToStartForQuest]]
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]), an input [[NCM_services#ApplicationId|ApplicationId]], and an input [[#IStorage]], no output.
|-
 
| 12 || [4.0.0+] [[#CreateApplicationAndRequestToStart]]
==== CreateApplicationAndRequestToStart ====
|-
Takes an input [[NCM_services#ApplicationId|ApplicationId]], no output.
| 13 || [4.0.0+] [[#CreateApplicationAndRequestToStartForQuest]]
 
|-
Same as [[#CreateApplicationAndPushAndRequestToStart]] except without the input storage, official sw uses this when no input storage is specified.
| 14 || [7.0.0+] [[#CreateApplicationWithAttributeAndPushAndRequestToStartForQuest]]
 
|-
==== CreateApplicationAndRequestToStartForQuest ====
| 15 || [7.0.0+] [[#CreateApplicationWithAttributeAndRequestToStartForQuest]]
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]) and an input [[NCM_services#ApplicationId|ApplicationId]], no output.
|-
 
| 20 || [[#EnsureSaveData]]
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except without the input storage, official sw uses this when no input storage is specified.
|-
 
| 21 || [[#GetDesiredLanguage]]
==== CreateApplicationWithAttributeAndPushAndRequestToStartForQuest ====
|-
Takes an input [[NCM_services#ApplicationId|ApplicationId]], a type-0x15 input buffer containing an [[#ApplicationAttribute]], an input [[#IStorage]], no output.
| 22 || [[#SetTerminateResult]]
 
|-
[21.0.0+] Now returns an output [[#IStorage]].
| 23 || [[#GetDisplayVersion]]
 
|-
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]].
| 24 || [2.0.0+] [[#GetLaunchStorageInfoForDebug]]
 
|-
==== CreateApplicationWithAttributeAndRequestToStartForQuest ====
| 25 || [3.0.0+] ExtendSaveData
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and a type-0x15 input buffer containing an [[#ApplicationAttribute]], no output.
|-
 
| 26 || [3.0.0+] GetSaveDataSize
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]].
|-
 
| 27 || [5.0.0+] CreateCacheStorage
==== EnsureSaveData ====
|-
Takes an input u128 userID, returns an output u64 size.
| 28 || [11.0.0+] [[#GetSaveDataSizeMax]]
 
|-
Calls sdk func <code>nn::fs::EnsureApplicationSaveData</code>. [[qlaunch]] also calls this same sdk func directly.
| 29 || [11.0.0+] [[#GetCacheStorageMax]]
 
|-
Creates the various savedata as specified by the application [[NACP_Format|control.nacp]] when the savedata doesn't exist.
| 30 || [[#BeginBlockingHomeButtonShortAndLongPressed]]
 
|-
Official user-processes launch the dataErase LibraryApplet depending on the Result, the above output size is used with this.
| 31 || [[#EndBlockingHomeButtonShortAndLongPressed]]
 
|-
==== GetDesiredLanguage ====
| 32 || [[#BeginBlockingHomeButton]]
No input, returns an output [[Settings_services#LanguageCode|LanguageCode]].
|-
 
| 33 || [[#EndBlockingHomeButton]]
==== SetTerminateResult ====
|-
Takes an input u32 '''Result''', no output.
| 34 || [10.0.0-15.0.1] [[#SelectApplicationLicense]]
 
|-
For example, in some cases official apps use this with [[Error_codes|error]] 0x2A2 then uses svcBreak.
| 35 || [11.0.0+] [[#GetDeviceSaveDataSizeMax]]
 
|-
==== GetDisplayVersion ====
| 36 || [14.0.0+] GetLimitedApplicationLicense
No input, returns an output 0x10-byte struct.
|-
 
| 37 || [14.0.0+] GetLimitedApplicationLicenseUpgradableEvent
The output struct is "nn::oe::DisplayVersion". This the DisplayVersion string copied from the application [[NACP_Format|control.nacp]], this is always NUL-terminated.
|-
 
| 40 || [[#NotifyRunning]]
==== GetLaunchStorageInfoForDebug ====
|-
No input, returns an output u8 [[Filesystem_services#StorageId|StorageId]] and u8 [[Filesystem_services#StorageId|StorageId]].
| 50 || [2.0.0+] [[#GetPseudoDeviceId]]
 
|-
This returns two u8s loaded from state, these are the same StorageIds from [[#ApplicationLaunchProperty]].
| 60 || [2.0.0+] [[#SetMediaPlaybackStateForApplication]]
 
|-
==== GetSaveDataSizeMax ====
| 65 || [3.0.0+] [[#IsGamePlayRecordingSupported]]
No input, returns two ouput s64s.
|-
 
| 66 || [3.0.0+] [[#InitializeGamePlayRecording]]
==== GetCacheStorageMax ====
|-
No input, returns an output s32 and s64.
| 67 || [3.0.0+] [[#SetGamePlayRecordingState]]
 
|-
==== BeginBlockingHomeButtonShortAndLongPressed ====
| 68 || [4.0.0+] [[#RequestFlushGamePlayingMovieForDebug]]
Takes an input s64, no output.
|-
 
| 70 || [3.0.0+] [[#RequestToShutdown]]
Official user-processes use hard-coded value 0 for the s64.
|-
 
| 71 || [3.0.0+] [[#RequestToReboot]]
Starts blocking the Home button.
|-
 
| 72 || [10.0.0+] [[#RequestToSleep]]
==== EndBlockingHomeButtonShortAndLongPressed ====
|-
No input/output.
| 80 || [4.0.0+] [[#ExitAndRequestToShowThanksMessage]]
 
|-
Ends the blocking started by [[#BeginBlockingHomeButtonShortAndLongPressed]].
| 90 || [4.0.0+] [[#EnableApplicationCrashReport]]
 
|-
==== BeginBlockingHomeButton ====
| 100 || [5.0.0+] [[#InitializeApplicationCopyrightFrameBuffer]]  
Takes an input s64 nanoseconds, no output. The input nanoseconds can be zero.
|-
 
| 101 || [5.0.0+] [[#SetApplicationCopyrightImage]]
==== EndBlockingHomeButton ====
|-
No input/output.
| 102 || [5.0.0+] [[#SetApplicationCopyrightVisibility]]
 
|-
==== SelectApplicationLicense ====
| 110 || [5.0.0+] [[#QueryApplicationPlayStatistics]]
Takes an input array of [[#ApplicationLicenseType]], returns an output [[#ApplicationLicenseType]].
|-
 
| 111 || [6.0.0+] [[#QueryApplicationPlayStatisticsByUid]]
==== GetDeviceSaveDataSizeMax ====
|-
No input, returns two output s64s.
| 112 || [20.0.0+]
 
|-
==== NotifyRunning ====
| 113 || [20.0.0+]
Takes no input. Returns an output u8 bool, which is ignored by official user-processes.
|-
 
| 120 || [5.0.0+] [[#ExecuteProgram]]
==== GetPseudoDeviceId ====
|-
No input, returns an output 0x10-byte "nn::util::Uuid" struct.
| 121 || [5.0.0+] [[#ClearUserChannel]]
 
|-
The 0x20-byte output data from [[NS_Services|GetSystemSeedForPseudoDeviceId]] followed by the 8-byte [[NACP_Format|SeedForPseudoDeviceId]] from the current control.nacp, is hashed with SHA1. Then "nn::util::GenerateUuidVersion5" is called with the final hash, the output from this is then returned for the Uuid.
| 122 || [5.0.0+] [[#UnpopToUserChannel]]
 
|-
==== SetMediaPlaybackStateForApplication ====
| 123 || [5.0.0+] [[#GetPreviousProgramIndex]]
Takes an input u8 bool, no output.
|-
 
| 124 || [6.0.0+] [[#EnableApplicationAllThreadDumpOnCrash]]
==== IsGamePlayRecordingSupported ====
|-
No input, returns an output u8 bool.
| 130 || [8.0.0+] [[#GetGpuErrorDetectedSystemEvent]]
 
|-
==== InitializeGamePlayRecording ====
| 131 || [11.0.0+] [[#SetDelayTimeToAbortOnGpuError]]
Takes a TransferMemory handle and an u64 for the size of the TransferMemory. The size must match 0x6000000 otherwise an error is returned.
|-
| 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]]
|-
| 210 || [20.0.0+]
|-
| 220 || [20.0.0+] [[#SetAudioOutputPolicy|SetAudioOutputPolicy]]
|-
| 230 || [S2] [20.0.0+] IsTensorRtSupported
|-
| 300 || [19.0.0+] [[#CreateMovieWriter]]
|-
| 310 || [20.0.0+] [[#RequestExitApplicationAndTryPopMessage|RequestExitApplicationAndTryPopMessage]]
|-
| 320 || [20.0.0+]
|-
| 321 || [S2] [20.0.0+]
|-
| 330 || [20.2.0+] IsLanguageSelectionLimited
|-
| 500 || [5.0.0+] [[#StartContinuousRecordingFlushForDebug]]
|-
| 1000 || [5.0.0+] [[#CreateMovieMaker]]
|-
| 1001 || [5.0.0+] [[#PrepareForJit]]
|}


==== SetGamePlayRecordingState ====
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):
Takes an input u32. 0 = disable/pause, 1 = enable/restart.
* [[SVC|Creates]] TransferMemory using the input buffer and size, with permissions=0.
* Uses [[#InitializeGamePlayRecording]] with the TransferMemory.
* Closes the TransferMemory handle, + TransferMemory cleanup.
* Uses [[#SetGamePlayRecordingState]] with value 0x1.
This GamePlayRecording functionality presumably enables the video-recording usable starting with [[4.0.0]].


==== RequestFlushGamePlayingMovieForDebug ====
==== PopLaunchParameter ====
No input/output.
Takes an input u32 [[#LaunchParameterKind]], returns an output [[#IStorage]].


Requests to save the video recording, as if the Capture-button was held.
Pops a LaunchParameter [[#IStorage]], the storage will be removed from sysmodule state during this.


==== RequestToShutdown ====
==== CreateApplicationAndPushAndRequestToStart ====
No input/output.
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and an input [[#IStorage]], no output. ApplicationId=0 can be used to relaunch the current application.


On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
==== CreateApplicationAndPushAndRequestToStartForQuest ====
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]), an input [[NCM_services#ApplicationId|ApplicationId]], and an input [[#IStorage]], no output.


==== RequestToReboot ====
==== CreateApplicationAndRequestToStart ====
No input/output.
Takes an input [[NCM_services#ApplicationId|ApplicationId]], no output.


On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
Same as [[#CreateApplicationAndPushAndRequestToStart]] except without the input storage, official sw uses this when no input storage is specified.


==== RequestToSleep ====
==== CreateApplicationAndRequestToStartForQuest ====
No input/output.
Takes 2 input u32s (loaded from struct [[#ApplicationAttributeForQuest]]) and an input [[NCM_services#ApplicationId|ApplicationId]], no output.


==== ExitAndRequestToShowThanksMessage ====
Same as [[#CreateApplicationAndPushAndRequestToStartForQuest]] except without the input storage, official sw uses this when no input storage is specified.
No input/output.


Used to exit the application and return to the kiosk menu. Official sw uses [[#UnlockExit]] immediately before this if needed.
==== CreateApplicationWithAttributeAndPushAndRequestToStartForQuest ====
Takes an input [[NCM_services#ApplicationId|ApplicationId]], a type-0x15 input buffer containing an [[#ApplicationAttribute]], an input [[#IStorage]], no output.


On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
[21.0.0+] Now returns an output [[#IStorage]].


This throws an error when the cached [[Settings_services#GetQuestFlag]] value is 0.
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]].


==== EnableApplicationCrashReport ====
==== CreateApplicationWithAttributeAndRequestToStartForQuest ====
Takes an input u8 bool, no output.
Takes an input [[NCM_services#ApplicationId|ApplicationId]] and a type-0x15 input buffer containing an [[#ApplicationAttribute]], no output.


==== InitializeApplicationCopyrightFrameBuffer ====
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]].
Takes an input TransferMemory handle, an s32 '''width''', an s32 '''height''', an u64 tmem_size, and no output.


tmem_size must be 0x40000-byte aligned. '''width''' must be 1-1280, and '''height''' must be 1-720.
==== EnsureSaveData ====
Takes an input u128 userID, returns an output u64 size.


User-processes create the tmem with an user-specified buffer with permissions=0. '''width''' = 1280 and '''height''' = 720.
Calls sdk func <code>nn::fs::EnsureApplicationSaveData</code>. [[qlaunch]] also calls this same sdk func directly.


After the validation checks pass the input is passed to [[OMM_services|ommdisp]] cmd500.
Creates the various savedata as specified by the application [[NACP_Format|control.nacp]] when the savedata doesn't exist.


This is used as an overlay for screenshots.
Official user-processes launch the dataErase LibraryApplet depending on the Result, the above output size is used with this.


==== SetApplicationCopyrightImage ====
==== GetDesiredLanguage ====
Takes a type-0x45 input buffer, an s32 '''x''', an s32 '''y''', an s32 '''width''', an s32 '''height''', an s32 [[#WindowOriginMode]], and no output.
No input, returns an output [[Settings_services#LanguageCode|LanguageCode]].


'''x''' and '''y''' must not have the negative bit set. '''width''' and '''height''' must not be <1.
==== SetTerminateResult ====
Takes an input u32 '''Result''', no output.


Sets the RGBA8 image for use with [[#InitializeApplicationCopyrightFrameBuffer]]. Overrides the current image, if this was already used previously.
For example, in some cases official apps use this with [[Error_codes|error]] 0x2A2 then uses svcBreak.


==== SetApplicationCopyrightVisibility ====
==== GetDisplayVersion ====
Takes an input u8 bool, no output.
No input, returns an output 0x10-byte struct.


Sets the visibility for the image set by [[#SetApplicationCopyrightImage]], in screenshots. By default it's visible.
The output struct is "nn::oe::DisplayVersion". This the DisplayVersion string copied from the application [[NACP_Format|control.nacp]], this is always NUL-terminated.


==== QueryApplicationPlayStatistics ====
==== GetLaunchStorageInfoForDebug ====
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.
No input, returns an output u8 [[Filesystem_services#StorageId|StorageId]] and u8 [[Filesystem_services#StorageId|StorageId]].


The number of entries in each array is the same.
This returns two u8s loaded from state, these are the same StorageIds from [[#ApplicationLaunchProperty]].


See also [[NACP_Format#PlayLogQueryCapability|PlayLogQueryCapability]].
==== GetSaveDataSizeMax ====
No input, returns two ouput s64s.


This uses [[Shared_Database_services|pdm:qry]] QueryApplicationPlayStatisticsForSystem.
==== GetCacheStorageMax ====
No input, returns an output s32 and s64.


==== QueryApplicationPlayStatisticsByUid ====
==== BeginBlockingHomeButtonShortAndLongPressed ====
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.
Takes an input s64, no output.


Same as [[#QueryApplicationPlayStatistics]] except this uses [[Shared_Database_services|pdm:qry]] cmd16, to get playstats specific to userIDs.  
Official user-processes use hard-coded value 0 for the s64.


==== ExecuteProgram ====
Starts blocking the Home button.
Takes an input u32 [[#ProgramSpecifyKind]] and an input u64, no output.


==== ClearUserChannel ====
==== EndBlockingHomeButtonShortAndLongPressed ====
No input/output.
No input/output.


Clears the UserChannel used by [[#UnpopToUserChannel]].
Ends the blocking started by [[#BeginBlockingHomeButtonShortAndLongPressed]].
 
==== BeginBlockingHomeButton ====
Takes an input s64 nanoseconds, no output. The input nanoseconds can be zero.
 
==== EndBlockingHomeButton ====
No input/output.


==== UnpopToUserChannel ====
==== SelectApplicationLicense ====
Takes an input [[#IStorage]], no output.
Takes an input array of [[#ApplicationLicenseType]], returns an output [[#ApplicationLicenseType]].


The input storage is pushed to the UserChannel. This is the same channel used by [[#LaunchParameterKind]] value 1.
==== GetDeviceSaveDataSizeMax ====
No input, returns two output s64s.


User-processes create a storage using data specified by the user (written to offset=0 size=inputsize), with max size 0x1000. This storage is then used with this cmd.
==== NotifyRunning ====
Takes no input. Returns an output u8 bool, which is ignored by official user-processes.


==== GetPreviousProgramIndex ====
==== GetPseudoDeviceId ====
No input, returns an output s32.
No input, returns an output 0x10-byte "nn::util::Uuid" struct.


Gets the ProgramIndex of the Application which launched this title. The output ProgramIndex is -1 when there was no previous title.
The 0x20-byte output data from [[NS_Services|GetSystemSeedForPseudoDeviceId]] followed by the 8-byte [[NACP_Format|SeedForPseudoDeviceId]] from the current control.nacp, is hashed with SHA1. Then "nn::util::GenerateUuidVersion5" is called with the final hash, the output from this is then returned for the Uuid.


==== EnableApplicationAllThreadDumpOnCrash ====
==== SetMediaPlaybackStateForApplication ====
Takes an input u8 bool, no output.
Takes an input u8 bool, no output.


==== GetGpuErrorDetectedSystemEvent ====
==== IsGamePlayRecordingSupported ====
No input, returns an output Event handle with autoclear=false.
No input, returns an output u8 bool.


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.
==== InitializeGamePlayRecording ====
 
Takes a TransferMemory handle and an u64 for the size of the TransferMemory. The size must match 0x6000000 otherwise an error is returned.
==== SetDelayTimeToAbortOnGpuError ====
 
Takes an input s64 "nn::TimeSpan", no output.
==== SetGamePlayRecordingState ====
Takes an input u32. 0 = disable/pause, 1 = enable/restart.


==== GetFriendInvitationStorageChannelEvent ====
==== RequestFlushGamePlayingMovieForDebug ====
No input, returns an output Event handle with EventClearMode=0.
No input/output.


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.
Requests to save the video recording, as if the Capture-button was held.


==== TryPopFromFriendInvitationStorageChannel ====
==== RequestToShutdown ====
No input, returns an output [[#IStorage]].
No input/output.


This uses the same StorageChannel as [[#PushToFriendInvitationStorageChannel]].
On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.


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.
==== RequestToReboot ====
No input/output.


==== GetNotificationStorageChannelEvent ====
On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.
No input, returns an output Event handle with EventClearMode=0.


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.
==== RequestToSleep ====
No input/output.


==== TryPopFromNotificationStorageChannel ====
==== ExitAndRequestToShowThanksMessage ====
No input, returns an output [[#IStorage]].
No input/output.


This uses the same StorageChannel as [[#PushToNotificationStorageChannel]].
Used to exit the application and return to the kiosk menu. Official sw uses [[#UnlockExit]] immediately before this if needed.


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.
On success, official sw will enter an infinite loop with sleep-thread value 86400000000000.


==== GetHealthWarningDisappearedSystemEvent ====
This throws an error when the cached [[Settings_services#GetQuestFlag]] value is 0.
No input, returns an output Event with EventClearMode=0.


==== SetHdcpAuthenticationActivated ====
==== EnableApplicationCrashReport ====
Takes an input u8 bool, no output.
Takes an input u8 bool, no output.


==== GetLaunchRequiredVersion ====
==== InitializeApplicationCopyrightFrameBuffer ====
Takes an input [[NCM_services#ApplicationId|ApplicationId]], an u64, returns an output [[#LaunchRequiredVersion]].
Takes an input TransferMemory handle, an s32 '''width''', an s32 '''height''', an u64 tmem_size, and no output.


sdknso passes hard-coded value 0 for the u64.
tmem_size must be 0x40000-byte aligned. '''width''' must be 1-1280, and '''height''' must be 1-720.


==== UpgradeLaunchRequiredVersion ====
User-processes create the tmem with an user-specified buffer with permissions=0. '''width''' = 1280 and '''height''' = 720.
Takes an input [[#LaunchRequiredVersion]], an [[NCM_services#ApplicationId|ApplicationId]], an u64, no output.


sdknso passes hard-coded value 0 for the u64.
After the validation checks pass the input is passed to [[OMM_services|ommdisp]] cmd500.


==== SendServerMaintenanceOverlayNotification ====
This is used as an overlay for screenshots.
Takes two input [[PCV_services#PosixTime|PosixTime]], no output.


The second input value can optionally be 0.
==== 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.


==== GetLastApplicationExitReason ====
'''x''' and '''y''' must not have the negative bit set. '''width''' and '''height''' must not be <1.
No input, returns an output s32.


==== Cmd210 ====
Sets the RGBA8 image for use with [[#InitializeApplicationCopyrightFrameBuffer]]. Overrides the current image, if this was already used previously.
No input, returns an output Event handle.


==== SetAudioOutputPolicy ====
==== SetApplicationCopyrightVisibility ====
Takes an input u8, no output.
Takes an input u8 bool, no output.


The input must be <=1.
Sets the visibility for the image set by [[#SetApplicationCopyrightImage]], in screenshots. By default it's visible.


==== CreateMovieWriter ====
==== QueryApplicationPlayStatistics ====
Takes 8-bytes of input and a handle. Returns an [[#IMovieWriter]].
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.


This internally uses the GRC cmd to open an [[GRC_services|IMovieWriter]]. This is therefore not usable on NX since that cmd is stubbed.
The number of entries in each array is the same.


==== RequestExitApplicationAndTryPopMessage ====
See also [[NACP_Format#PlayLogQueryCapability|PlayLogQueryCapability]].
Takes an input [[#IStorage|IStorage]], no output.


[21.0.0+] Now additionally takes a total of 0x18-bytes of input.
This uses [[Shared_Database_services|pdm:qry]] QueryApplicationPlayStatisticsForSystem.


==== IsLanguageSelectionLimited ====
==== QueryApplicationPlayStatisticsByUid ====
No input, returns 1-byte of output.
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.


On NX this just writes 0 to output and returns 0.
Same as [[#QueryApplicationPlayStatistics]] except this uses [[Shared_Database_services|pdm:qry]] cmd16, to get playstats specific to userIDs.  


==== StartContinuousRecordingFlushForDebug ====
==== ExecuteProgram ====
Takes an input s64 nanoseconds-value, returns an output Event handle with autoclear=false.
Takes an input u32 [[#ProgramSpecifyKind]] and an input u64, no output.


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.
==== ClearUserChannel ====
No input/output.


==== CreateMovieMaker ====
Clears the UserChannel used by [[#UnpopToUserChannel]].
Takes an input u64 size and a TransferMemory handle, returns an [[#IMovieMaker]].


Official sw retries using the cmd in a loop on error 0x8D4 with svcSleepThread(100000000) being used first.
==== UnpopToUserChannel ====
Takes an input [[#IStorage]], no output.


Official sw uses permissions=None for the TransferMemory, with an user-specified buffer. The size of the buffer used by official sw is 0x6000000.
The input storage is pushed to the UserChannel. This is the same channel used by [[#LaunchParameterKind]] value 1.


==== PrepareForJit ====
User-processes create a storage using data specified by the user (written to offset=0 size=inputsize), with max size 0x1000. This storage is then used with this cmd.
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.


~IApplicationFunctions() includes:
==== GetPreviousProgramIndex ====
No input, returns an output s32.


    if (this->jit_process) {
Gets the ProgramIndex of the Application which launched this title. The output ProgramIndex is -1 when there was no previous title.
        Terminate(this->jit_process);
        this->jit_process = nullptr;
    }


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.
==== EnableApplicationAllThreadDumpOnCrash ====
Takes an input u8 bool, no output.


AM can also optionally launch jit-sysmodule automatically if the [[NACP]] enables it.
==== GetGpuErrorDetectedSystemEvent ====
No input, returns an output Event handle with autoclear=false.


[S2] This is no longer usable since this returns Result 0x408 (sysmodule doesn't exist).
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.


=== IMovieWriter ===
==== SetDelayTimeToAbortOnGpuError ====
This is "nn::am::service::IMovieWriter".
Takes an input s64 "nn::TimeSpan", no output.


This was added with [19.0.0+].
==== 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.


{| class="wikitable" border="1"
==== TryPopFromFriendInvitationStorageChannel ====
|-
No input, returns an output [[#IStorage]].
! Cmd || Name
|-
| 0 ||
|}


==== Cmd0 ====
This uses the same StorageChannel as [[#PushToFriendInvitationStorageChannel]].
No input. Returns a GRC [[GRC_services|IMovieWriter]].


=== IMovieMaker ===
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.
This is "nn::am::service::IMovieMaker".


{| class="wikitable" border="1"
==== GetNotificationStorageChannelEvent ====
|-
No input, returns an output Event handle with EventClearMode=0.
! Cmd || Name
|-
| 0 || [[#GetGrcMovieMaker]]
|-
| 1 || [[#GetLayerHandle]]
|}


==== GetGrcMovieMaker ====
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.
No input, returns a GRC [[GRC_services|IMovieMaker]].


==== GetLayerHandle ====
==== TryPopFromNotificationStorageChannel ====
No input, returns an output u64.
No input, returns an output [[#IStorage]].


== ILibraryAppletCreator ==
This uses the same StorageChannel as [[#PushToNotificationStorageChannel]].
This is "nn::am::service::ILibraryAppletCreator".


{| class="wikitable" border="1"
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.
|-
! Cmd || Name || Notes
|-
| 0 || [[#CreateLibraryAppletOld|CreateLibraryAppletOld]] ([1.0.0-19.0.1] CreateLibraryApplet) ||
|-
| 1 || [[#TerminateAllLibraryApplets]] ||
|-
| 2 || [[#AreAnyLibraryAppletsLeft]] ||
|-
| 3 || [20.0.0+] [[#CreateLibraryApplet|CreateLibraryApplet]] ||
|-
| 10 || [[#CreateStorage]] ||
|-
| 11 || [[#CreateTransferMemoryStorage]] ||
|-
| 12 || [2.0.0+] [[#CreateHandleStorage]] ||
|}


=== CreateLibraryAppletOld ===
==== GetHealthWarningDisappearedSystemEvent ====
Unofficial name.
No input, returns an output Event with EventClearMode=0.


Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], returns an [[#ILibraryAppletAccessor]].
==== SetHdcpAuthenticationActivated ====
Takes an input u8 bool, no output.


=== TerminateAllLibraryApplets ===
==== GetLaunchRequiredVersion ====
No input/output.
Takes an input [[NCM_services#ApplicationId|ApplicationId]], an u64, returns an output [[#LaunchRequiredVersion]].


Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
sdknso passes hard-coded value 0 for the u64.


Terminates all LibraryApplets which were created by the current applet (or by the Application when used from the [[#IApplicationAccessor]] cmd).
==== UpgradeLaunchRequiredVersion ====
Takes an input [[#LaunchRequiredVersion]], an [[NCM_services#ApplicationId|ApplicationId]], an u64, no output.


=== AreAnyLibraryAppletsLeft ===
sdknso passes hard-coded value 0 for the u64.
No input, returns an output u8 bool.


Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
==== SendServerMaintenanceOverlayNotification ====
Takes two input [[PCV_services#PosixTime|PosixTime]], no output.


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).
The second input value can optionally be 0.


=== CreateLibraryApplet ===
==== GetLastApplicationExitReason ====
Unofficial name.
No input, returns an output s32.
 
==== Cmd210 ====
No input, returns an output Event handle.
 
==== SetAudioOutputPolicy ====
Takes an input u8, no output.


Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], an u64 ThreadId, returns an [[#ILibraryAppletAccessor]].
The input must be <=1.


The ThreadId is from the current-thread of the user-process which is using the cmd.
==== CreateMovieWriter ====
Takes 8-bytes of input and a handle. Returns an [[#IMovieWriter]].


=== CreateStorage ===
This internally uses the GRC cmd to open an [[GRC_services|IMovieWriter]]. This is therefore not usable on NX since that cmd is stubbed.
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]].
==== RequestExitApplicationAndTryPopMessage ====
Takes an input [[#IStorage|IStorage]], no output.


=== CreateTransferMemoryStorage ===
[21.0.0+] Now additionally takes a total of 0x18-bytes of input.
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.
==== IsLanguageSelectionLimited ====
No input, returns 1-byte of output.


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.
On NX this just writes 0 to output and returns 0.


=== CreateHandleStorage ===
==== StartContinuousRecordingFlushForDebug ====
Takes an input copy-handle and an input s64, returns an [[#IStorage]]. In some cases the s64 must not have the negative bit set.
Takes an input s64 nanoseconds-value, returns an output Event handle with autoclear=false.


The input can be arbitrary, however official sw is only (?) known to use this for TransferMemory (with s64=size).
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.


=== ILibraryAppletAccessor ===
==== CreateMovieMaker ====
This is "nn::am::service::ILibraryAppletAccessor".
Takes an input u64 size and a TransferMemory handle, returns an [[#IMovieMaker]].


{| class="wikitable" border="1"
Official sw retries using the cmd in a loop on error 0x8D4 with svcSleepThread(100000000) being used first.
|-
 
! Cmd || Name || Notes
Official sw uses permissions=None for the TransferMemory, with an user-specified buffer. The size of the buffer used by official sw is 0x6000000.
|-
 
| 0 || [[#GetAppletStateChangedEvent]] ||
==== 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.
 
~IApplicationFunctions() includes:
 
    if (this->jit_process) {
        Terminate(this->jit_process);
        this->jit_process = nullptr;
    }
 
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.
 
AM can also optionally launch jit-sysmodule automatically if the [[NACP]] enables it.
 
[S2] This is no longer usable since this returns Result 0x408 (sysmodule doesn't exist).
 
=== IMovieWriter ===
This is "nn::am::service::IMovieWriter".
 
This was added with [19.0.0+].
 
{| class="wikitable" border="1"
|-
|-
| 1 || [[#IsCompleted]] ||
! Cmd || Name
|-
|-
| 10 || [[#Start]] ||
| 0 ||  
|}
 
==== Cmd0 ====
No input. Returns a GRC [[GRC_services|IMovieWriter]].
 
=== IMovieMaker ===
This is "nn::am::service::IMovieMaker".
 
{| class="wikitable" border="1"
|-
|-
| 20 || [[#RequestExit]] ||
! Cmd || Name
|-
|-
| 25 || [[#Terminate]] ||
| 0 || [[#GetGrcMovieMaker]]
|-
|-
| 30 || [[#GetResult]] ||
| 1 || [[#GetLayerHandle]]
|}
 
==== GetGrcMovieMaker ====
No input, returns a GRC [[GRC_services|IMovieMaker]].
 
==== GetLayerHandle ====
No input, returns an output u64.
 
=== IPerformanceFunctions ===
This is "nn::am::service::IPerformanceFunctions".
 
This is exclusive to Switch 2.
 
{| class="wikitable" border="1"
|-
|-
| 50 || [[#SetOutOfFocusApplicationSuspendingEnabled]] ||
! Cmd || Name
|-
|-
| 60 || [10.0.0+] [[#PresetLibraryAppletGpuTimeSliceZero]] ||
| 0 || IsCpuOverclockEnabled
|-
|-
| 80 || [19.0.0+] RequestForLibraryAppletToGetForeground ||
| 1 || SetCpuOverclockEnabled
|}
 
=== IGraphicsScalingParametersFunctions ===
This is "nn::am::service::IGraphicsScalingParametersFunctions".
 
This is exclusive to Switch 2.
 
{| class="wikitable" border="1"
|-
|-
| 81 || [19.0.0+] GetCurrentChildLibraryApplet ||
! Cmd || Name
|-
|-
| 90 || [20.0.0+] ||
| 10 || GetGraphicsScalingParameters
|-
|-
| 100 || [[#PushInData]] ||  
| 1000 || SetSupportingGraphicsScalingParametersForDebug
|-
|-
| 101 || [[#PopOutData]] ||  
| 1010 || SetGpuQuotaForDebug
|-
|-
| 102 || [[#PushExtraStorage]] ||  
| 1020 || ClearGpuQuotaForDebug
|-
|-
| 103 || [[#PushInteractiveInData]] ||  
| 1030 || SetScreenRatioForDebug
|-
|-
| 104 || [[#PopInteractiveOutData]] ||  
| 1040 || ClearScreenRatioForDebug
|-
|-
| 105 || [[#GetPopOutDataEvent]] ||
| 1050 || SetGraphicsScaleChangedNotificationEnabled
|}
 
== ILibraryAppletCreator ==
This is "nn::am::service::ILibraryAppletCreator".
 
{| class="wikitable" border="1"
|-
|-
| 106 || [[#GetPopInteractiveOutDataEvent]] ||
! Cmd || Name || Notes
|-
|-
| 110 || [[#NeedsToExitProcess]] ||
| 0 || [[#CreateLibraryAppletOld|CreateLibraryAppletOld]] ([1.0.0-19.0.1] CreateLibraryApplet) ||  
|-
|-
| 120 || [[#GetLibraryAppletInfo]] ||  
| 1 || [[#TerminateAllLibraryApplets]] ||
|-
| 2 || [[#AreAnyLibraryAppletsLeft]] ||
|-
| 3 || [20.0.0+] [[#CreateLibraryApplet|CreateLibraryApplet]] ||
|-
|-
| 150 || [[#RequestForAppletToGetForeground]] ||
| 10 || [[#CreateStorage]] ||  
|-
|-
| 160 || [2.0.0+] [[#GetIndirectLayerConsumerHandle]] ||
| 11 || [[#CreateTransferMemoryStorage]] ||  
|-
|-
| 170 || [22.0.0+]
| 12 || [2.0.0+] [[#CreateHandleStorage]] ||
|}
|}


Commands <=30 are inherited from [[#IAppletAccessor]]. GetLibraryAppletInfo is identical to the [[#ILibraryAppletSelfAccessor]] cmd.
=== CreateLibraryAppletOld ===
Unofficial name.


==== SetOutOfFocusApplicationSuspendingEnabled ====
Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], returns an [[#ILibraryAppletAccessor]].
Takes an input u8 bool, no output.


Official sw will assert prior to using this if applet-service was not initialized as *Application.
=== TerminateAllLibraryApplets ===
 
==== PresetLibraryAppletGpuTimeSliceZero ====
No input/output.
No input/output.


sdknso only uses with with [[Software_Keyboard|swkbd-inline]], immediately after creating the LibraryApplet.
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.


==== PushInData ====
Terminates all LibraryApplets which were created by the current applet (or by the Application when used from the [[#IApplicationAccessor]] cmd).
Takes an input [[#IStorage]], no output.


==== PopOutData ====
=== AreAnyLibraryAppletsLeft ===
No input, returns an output [[#IStorage]].
No input, returns an output u8 bool.


==== PushExtraStorage ====
Stubbed with an ILibraryAppletCreator from [[#CreateSelfLibraryAppletCreatorForDevelop]], just returns an error.
Takes an input [[#IStorage]], no output.


==== PushInteractiveInData ====
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).
Takes an input [[#IStorage]], no output.


==== PopInteractiveOutData ====
=== CreateLibraryApplet ===
No input, returns an output [[#IStorage]].
Unofficial name.


==== GetPopOutDataEvent ====
Takes 2 input u32s [[#AppletId]] and [[#LibraryAppletMode]], an u64 ThreadId, returns an [[#ILibraryAppletAccessor]].
No input, returns an output handle with autoclear=false.
 
The ThreadId is from the current-thread of the user-process which is using the cmd.


==== GetPopInteractiveOutDataEvent ====
=== CreateStorage ===
No input, returns an output event handle with autoclear=false.
Takes an input s64 for the storage size, returns an [[#IStorage]].


==== NeedsToExitProcess ====
This allocates a buffer with the specified size which can then be accessed via [[#IStorageAccessor]].
No input, returns an output u8 bool.


Stubbed, just returns an error.
=== CreateTransferMemoryStorage ===
Takes an input TransferMemory copy-handle, an input u8 bool, and an s64 size, returns an [[#IStorage]].


==== RequestForAppletToGetForeground ====
The user-process creates the TransferMemory with permissions=0.
No input/output.


Stubbed, just returns an error.
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.


==== GetIndirectLayerConsumerHandle ====
=== CreateHandleStorage ===
Takes an input PID and an input u64 AppletResourceUserId, returns an output u64 IndirectLayerConsumerHandle.
Takes an input copy-handle and an input s64, returns an [[#IStorage]]. In some cases the s64 must not have the negative bit set.


Official sw uses this during LibraryApplet creation when [[#LibraryAppletMode]] is 0x3.
The input can be arbitrary, however official sw is only (?) known to use this for TransferMemory (with s64=size).


== ICommonStateGetter ==
=== ILibraryAppletAccessor ===
This is "nn::am::service::ICommonStateGetter".
This is "nn::am::service::ILibraryAppletAccessor".


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
! 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]]
| 70 || [S2] ||
|-
|-
| 9 || [[#GetCurrentFocusState]]
| 80 || [19.0.0+] RequestForLibraryAppletToGetForeground ||
|-
|-
| 10 || [[#RequestToAcquireSleepLock]]
| 81 || [19.0.0+] GetCurrentChildLibraryApplet ||
|-
|-
| 11 || [[#ReleaseSleepLock]]
| 90 || [20.0.0+] ||
|-
|-
| 12 || [[#ReleaseSleepLockTransiently]]
| 100 || [[#PushInData]] ||
|-
|-
| 13 || [[#GetAcquiredSleepLockEvent]]
| 101 || [[#PopOutData]] ||
|-
|-
| 14 || [11.0.0+] [[#GetWakeupCount]]
| 102 || [[#PushExtraStorage]] ||
|-
|-
| 15 || [19.0.0+]  
| 103 || [[#PushInteractiveInData]] ||
|-
|-
| 20 || [[#PushToGeneralChannel]]
| 104 || [[#PopInteractiveOutData]] ||
|-
|-
| 30 || [[#GetHomeButtonReaderLockAccessor]]
| 105 || [[#GetPopOutDataEvent]] ||
|-
|-
| 31 || [2.0.0+] [[#GetReaderLockAccessorEx]]
| 106 || [[#GetPopInteractiveOutDataEvent]] ||
|-
|-
| 32 || [7.0.0+] [[#GetWriterLockAccessorEx]]
| 110 || [[#NeedsToExitProcess]] ||
|-
|-
| 40 || [2.0.0+] [[#GetCradleFwVersion]]
| 120 || [[#GetLibraryAppletInfo]] ||
|-
|-
| 50 || [3.0.0+] [[#IsVrModeEnabled]]
| 150 || [[#RequestForAppletToGetForeground]] ||
|-
|-
| 51 || [3.0.0+] [[#SetVrModeEnabled]]
| 160 || [2.0.0+] [[#GetIndirectLayerConsumerHandle]] ||
|-
|-
| 52 || [4.0.0+] [[#SetLcdBacklighOffEnabled]]
| 170 || [22.0.0+]
|-
|}
| 53 || [7.0.0+] [[#BeginVrModeEx]]
 
|-
Commands <=30 are inherited from [[#IAppletAccessor]]. GetLibraryAppletInfo is identical to the [[#ILibraryAppletSelfAccessor]] cmd.
| 54 || [7.0.0+] [[#EndVrModeEx]]
 
|-
==== SetOutOfFocusApplicationSuspendingEnabled ====
| 55 || [3.0.0+] [[#IsInControllerFirmwareUpdateSection]]
Takes an input u8 bool, no output.
|-
 
| 59 || [11.0.0+] [[#SetVrPositionForDebug]]
Official sw will assert prior to using this if applet-service was not initialized as *Application.
|-
 
| 60 || [3.0.0+] [[#GetDefaultDisplayResolution]]
==== PresetLibraryAppletGpuTimeSliceZero ====
|-
No input/output.
| 61 || [3.0.0+] [[#GetDefaultDisplayResolutionChangeEvent]]
 
|-
sdknso only uses with with [[Software_Keyboard|swkbd-inline]], immediately after creating the LibraryApplet.
| 62 || [4.0.0+] [[#GetHdcpAuthenticationState]]
 
|-
==== PushInData ====
| 63 || [4.0.0+] [[#GetHdcpAuthenticationStateChangeEvent]]
Takes an input [[#IStorage]], no output.
|-
 
| 64 || [5.0.0+] [[#SetTvPowerStateMatchingMode]]
==== PopOutData ====
|-
No input, returns an output [[#IStorage]].
| 65 || [5.1.0+] [[#GetApplicationIdByContentActionName]]
 
|-
==== PushExtraStorage ====
| 66 || [6.0.0+] [[#SetCpuBoostMode]]
Takes an input [[#IStorage]], no output.
|-
 
| 67 || [10.0.0+] [[#CancelCpuBoostMode]]
==== PushInteractiveInData ====
Takes an input [[#IStorage]], no output.
 
==== PopInteractiveOutData ====
No input, returns an output [[#IStorage]].
 
==== GetPopOutDataEvent ====
No input, returns an output handle with autoclear=false.
 
==== GetPopInteractiveOutDataEvent ====
No input, returns an output event handle with autoclear=false.
 
==== NeedsToExitProcess ====
No input, returns an output u8 bool.
 
Stubbed, just returns an error.
 
==== RequestForAppletToGetForeground ====
No input/output.
 
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 ==
This is "nn::am::service::ICommonStateGetter".
 
{| class="wikitable" border="1"
|-
|-
| 68 || [11.0.0+] [[#GetBuiltInDisplayType]]
! Cmd || Name
|-
|-
| 80 || [6.0.0+] [[#PerformSystemButtonPressingIfInFocus]]
| 0 || [[#GetEventHandle]]
|-
|-
| 90 || [7.0.0+] [[#SetPerformanceConfigurationChangedNotification]]
| 1 || [[#ReceiveMessage]]
|-
|-
| 91 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
| 2 || [[#GetThisAppletKind]]
|-
|-
| 100 || [9.1.0+] [[#SetHandlingHomeButtonShortPressedEnabled]]
| 3 || [[#AllowToEnterSleep]]
|-
|-
| 110 || [11.0.0+] [[#OpenMyGpuErrorHandler]]
| 4 || [[#DisallowToEnterSleep]]
|-
|-
| 120 || [13.0.0+] GetAppletLaunchedHistory
| 5 || [[#GetOperationMode]]
|-
| 6 || [[#GetPerformanceMode]]
|-
| 7 || [[#GetCradleStatus]]
|-
|-
| 130 || [21.0.0+]
| 8 || [[#GetBootMode]]
|-
|-
| 200 || [7.0.0+] [[#GetOperationModeSystemInfo]]
| 9 || [[#GetCurrentFocusState]]
|-
|-
| 300 || [9.0.0+] [[#GetSettingsPlatformRegion]]
| 10 || [[#RequestToAcquireSleepLock]]
|-
|-
| 400 || [10.0.0+] [[#ActivateMigrationService]]
| 11 || [[#ReleaseSleepLock]]
|-
|-
| 401 || [10.0.0+] [[#DeactivateMigrationService]]
| 12 || [[#ReleaseSleepLockTransiently]]
|-
|-
| 500 || [11.0.0+] [[#DisableSleepTillShutdown]]
| 13 || [[#GetAcquiredSleepLockEvent]]
|-
|-
| 501 || [11.0.0+] [[#SuppressDisablingSleepTemporarily]]
| 14 || [11.0.0+] [[#GetWakeupCount]]
|-
|-
| 502 || [12.0.0+] IsSleepEnabled
| 15 || [19.0.0+]  
|-
|-
| 503 || [12.0.0+] IsDisablingSleepSuppressed
| 20 || [[#PushToGeneralChannel]]
|-
|-
| 600 || [20.0.0+] ([17.0.0-18.1.0] OpenNamedChannelAsChild)
| 30 || [[#GetHomeButtonReaderLockAccessor]]
|-
|-
| 610 || [21.0.0+]
| 31 || [2.0.0+] [[#GetReaderLockAccessorEx]]
|-
|-
| 611 || [22.0.0+]
| 32 || [7.0.0+] [[#GetWriterLockAccessorEx]]
|-
|-
| 900 || [11.0.0+] [[#SetRequestExitToLibraryAppletAtExecuteNextProgramEnabled]]
| 40 || [2.0.0+] [[#GetCradleFwVersion]]
|-
|-
| 910 || [17.0.0+] GetLaunchRequiredTick
| 50 || [3.0.0+] [[#IsVrModeEnabled]]
|-
|-
| 1000 || [19.0.0+] BeginVrMode3d
| 51 || [3.0.0+] [[#SetVrModeEnabled]]
|-
|-
| 1001 || [19.0.0+] EndVrMode3d
| 52 || [4.0.0+] [[#SetLcdBacklighOffEnabled]]
|-
|-
| 1002 || [19.0.0+] IsVrModeEnabled3d
| 53 || [7.0.0+] [[#BeginVrModeEx]]
|-
|-
| 1003 || [21.0.0+]
| 54 || [7.0.0+] [[#EndVrModeEx]]
|-
|-
| 1004 || [21.0.0+]
| 55 || [3.0.0+] [[#IsInControllerFirmwareUpdateSection]]
|-
|-
| 1005 || [21.0.0+]
| 59 || [11.0.0+] [[#SetVrPositionForDebug]]
|}
|-
 
| 60 || [3.0.0+] [[#GetDefaultDisplayResolution]]
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]]).
|-
 
| 61 || [3.0.0+] [[#GetDefaultDisplayResolutionChangeEvent]]
[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.
|-
 
| 62 || [4.0.0+] [[#GetHdcpAuthenticationState]]
=== GetEventHandle ===
|-
No input. Returns an output event handle. This is signalled when a message is available with [[#ReceiveMessage]].
| 63 || [4.0.0+] [[#GetHdcpAuthenticationStateChangeEvent]]
 
|-
=== ReceiveMessage ===
| 64 || [5.0.0+] [[#SetTvPowerStateMatchingMode]]
No input. Returns an output [[#AppletMessage]]. Error 0x680 indicates no message is available.
|-
 
| 65 || [5.1.0+] [[#GetApplicationIdByContentActionName]]
=== GetThisAppletKind ===
|-
No input, returns an output [[#AppletKind]].
| 66 || [6.0.0+] [[#SetCpuBoostMode]]
 
|-
Stubbed, just returns an error.
| 67 || [10.0.0+] [[#CancelCpuBoostMode]]
 
|-
=== AllowToEnterSleep ===
| 68 || [11.0.0+] [[#GetBuiltInDisplayType]]
No input/output.
|-
 
| 80 || [6.0.0+] [[#PerformSystemButtonPressingIfInFocus]]
Stubbed, just returns an error.
|-
 
| 90 || [7.0.0+] [[#SetPerformanceConfigurationChangedNotification]]
=== DisallowToEnterSleep ===
|-
No input/output.
| 91 || [7.0.0+] [[#GetCurrentPerformanceConfiguration]]
 
|-
Stubbed, just returns an error.
| 100 || [9.1.0+] [[#SetHandlingHomeButtonShortPressedEnabled]]
 
|-
=== GetOperationMode ===
| 110 || [11.0.0+] [[#OpenMyGpuErrorHandler]]
No input. Returns an output u8 for the current [[#OperationMode]].
|-
 
| 120 || [13.0.0+] GetAppletLaunchedHistory
=== GetPerformanceMode ===
|-
No input. Returns an output u32 for the current [[#PerformanceMode]].
| 130 || [21.0.0+] EnableStartupLogoDisappearedMessage
 
|-
=== GetCradleStatus ===
| 200 || [7.0.0+] [[#GetOperationModeSystemInfo]]
No input, returns an output u8.
|-
 
| 300 || [9.0.0+] [[#GetSettingsPlatformRegion]]
This uses [[#omm]] GetCradleStatus.
|-
 
| 400 || [10.0.0+] [[#ActivateMigrationService]]
=== GetBootMode ===
|-
No input, returns an output u8.
| 401 || [10.0.0+] [[#DeactivateMigrationService]]
 
|-
Returns the value from [[Process_Manager_services|pm:bm]] GetBootMode.
| 500 || [11.0.0+] [[#DisableSleepTillShutdown]]
 
|-
=== GetCurrentFocusState ===
| 501 || [11.0.0+] [[#SuppressDisablingSleepTemporarily]]
No input. Returns an output u8 [[#FocusState]].
|-
| 502 || [12.0.0+] IsSleepEnabled
|-
| 503 || [12.0.0+] IsDisablingSleepSuppressed
|-
| 600 || [20.0.0+] SetHidInputMagnificationForApplication ([17.0.0-18.1.0] OpenNamedChannelAsChild)
|-
| 610 || [21.0.0+]
|-
| 611 || [22.0.0+]
|-
| 650 || [S2] BeginUsingCameraResource
|-
| 651 || [S2] EndUsingCameraResource
|-
| 900 || [11.0.0+] [[#SetRequestExitToLibraryAppletAtExecuteNextProgramEnabled]]
|-
| 910 || [17.0.0+] GetLaunchRequiredTick
|-
| 1000 || [19.0.0+] BeginVrMode3d
|-
| 1001 || [19.0.0+] EndVrMode3d
|-
| 1002 || [19.0.0+] IsVrModeEnabled3d
|-
| 1003 || [21.0.0+] GetVrLaboGoggleViewport
|-
| 1004 || [21.0.0+] GetPanelPhysicalSizeForSpecificTitle
|-
| 1005 || [21.0.0+] GetPanelResolutionForSpecificTitle
|-
| 2000 || [S2] SetRtcModeChangedMessageEnabled
|-
| 2010 || [S2] GetCurrentDisplayLayoutRatio
|}


=== RequestToAcquireSleepLock ===
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/output.


=== ReleaseSleepLock ===
[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.
No input/output.


=== ReleaseSleepLockTransiently ===
=== GetEventHandle ===
No input/output.
No input. Returns an output event handle. This is signalled when a message is available with [[#ReceiveMessage]].


=== GetAcquiredSleepLockEvent ===
=== ReceiveMessage ===
No input, returns an output Event handle with autoclear=false.
No input. Returns an output [[#AppletMessage]]. Error 0x680 indicates no message is available.


=== GetWakeupCount ===
=== GetThisAppletKind ===
No input, returns an output u64.
No input, returns an output [[#AppletKind]].


=== PushToGeneralChannel ===
Stubbed, just returns an error.
Takes an input [[#IStorage]], no output.


This is not usable under an Application, however it is usable under a LibraryApplet.
=== AllowToEnterSleep ===
No input/output.


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:
Stubbed, just returns an error.
* <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.


=== GetHomeButtonReaderLockAccessor ===
=== DisallowToEnterSleep ===
No input, returns an output [[#ILockAccessor]].
No input/output.


Similar to using [[#GetReaderLockAccessorEx]] with inval=0.
Stubbed, just returns an error.


=== GetReaderLockAccessorEx ===
=== GetOperationMode ===
Takes an input u32, returns an output [[#ILockAccessor]].
No input. Returns an output u8 for the current [[#OperationMode]].


The input value must be 0-3. 0 = HomeButton.
=== GetPerformanceMode ===
No input. Returns an output u32 for the current [[#PerformanceMode]].


=== GetWriterLockAccessorEx ===
=== GetCradleStatus ===
Takes an input u32, returns an output [[#ILockAccessor]].
No input, returns an output u8.


The input value must be 0-3. 0 = HomeButton.
This uses [[#omm]] GetCradleStatus.


=== GetCradleFwVersion ===
=== GetBootMode ===
No input, returns 4 output u32s.
No input, returns an output u8.


This uses [[#omm]] GetCradleFwVersion.
Returns the value from [[Process_Manager_services|pm:bm]] GetBootMode.


=== IsVrModeEnabled ===
=== GetCurrentFocusState ===
No input, returns an output u8 bool.
No input. Returns an output u8 [[#FocusState]].


=== SetVrModeEnabled ===
=== RequestToAcquireSleepLock ===
Takes an input u8 bool flag. No output.
No input/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}.
=== ReleaseSleepLock ===
No input/output.


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.
=== ReleaseSleepLockTransiently ===
No input/output.


=== SetLcdBacklighOffEnabled ===
=== GetAcquiredSleepLockEvent ===
Takes an input u8 bool, no output.
No input, returns an output Event handle with autoclear=false.


Sets whether the LCD screen blacklight is turned off.
=== GetWakeupCount ===
No input, returns an output u64.


=== BeginVrModeEx ===
=== PushToGeneralChannel ===
No input/output.
Takes an input [[#IStorage]], no output.


Identical to [[#SetVrModeEnabled]] except with hard-coded flag=1.
This is not usable under an Application, however it is usable under a LibraryApplet.


=== EndVrModeEx ===
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/output.
* <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.


Identical to [[#SetVrModeEnabled]] except with hard-coded flag=0.
=== GetHomeButtonReaderLockAccessor ===
No input, returns an output [[#ILockAccessor]].


=== IsInControllerFirmwareUpdateSection ===
Similar to using [[#GetReaderLockAccessorEx]] with inval=0.
No input, returns an output u8 bool.


=== SetVrPositionForDebug ===
=== GetReaderLockAccessorEx ===
Takes 4 input s32s, no output.
Takes an input u32, returns an output [[#ILockAccessor]].


The s32s are: x, y, width, height.
The input value must be 0-3. 0 = HomeButton.


The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
=== GetWriterLockAccessorEx ===
Takes an input u32, returns an output [[#ILockAccessor]].
 
The input value must be 0-3. 0 = HomeButton.


width must be 1-1280, height must be 1-720.
=== GetCradleFwVersion ===
No input, returns 4 output u32s.


x and y must not be negative. x+width must be <=1280. y+height must be <=720.
This uses [[#omm]] GetCradleFwVersion.


=== GetDefaultDisplayResolution ===
=== IsVrModeEnabled ===
No input, returns two output s32s '''width''' and '''height'''.
No input, returns an output u8 bool.


=== GetDefaultDisplayResolutionChangeEvent ===
=== SetVrModeEnabled ===
No input, returns an output Event handle with autoclear=true.
Takes an input u8 bool flag. No output.


=== GetHdcpAuthenticationState ===
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 an output s32.


=== GetHdcpAuthenticationStateChangeEvent ===
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 Event handle with autoclear=true.


=== SetTvPowerStateMatchingMode ===
=== SetLcdBacklighOffEnabled ===
Takes an input s32 [[#TvPowerStateMatchingMode]], no output.
Takes an input u8 bool, no output.


=== GetApplicationIdByContentActionName ===
Sets whether the LCD screen blacklight is turned off.
Takes a type-0x5 input buffer containing a string, returns an output [[NCM_services#ApplicationId|ApplicationId]].


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).
=== BeginVrModeEx ===
No input/output.


=== SetCpuBoostMode ===
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=1.
Takes an input u32 [[#CpuBoostMode]] and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].


=== CancelCpuBoostMode ===
=== EndVrModeEx ===
No input/output.
No input/output.


=== GetBuiltInDisplayType ===
Identical to [[#SetVrModeEnabled]] except with hard-coded flag=0.
No input, returns an output s32.


This is not exposed by sdknso.
=== IsInControllerFirmwareUpdateSection ===
No input, returns an output u8 bool.


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].
=== SetVrPositionForDebug ===
Takes 4 input s32s, no output.


=== PerformSystemButtonPressingIfInFocus ===
The s32s are: x, y, width, height.
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.
The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.


=== SetPerformanceConfigurationChangedNotification ===
width must be 1-1280, height must be 1-720.
Takes an input u8 bool, no output.


=== GetCurrentPerformanceConfiguration ===
x and y must not be negative. x+width must be <=1280. y+height must be <=720.
No input, returns the result of calling [[PPC_services#apm:sys|GetCurrentPerformanceConfiguration]].


=== OpenMyGpuErrorHandler ===
=== GetDefaultDisplayResolution ===
No input, returns an [[#IGpuErrorHandler]].
No input, returns two output s32s '''width''' and '''height'''.


The cached value loaded from [[Settings_services#GetDebugModeFlag]] must be 1, otherwise an error is returned.
=== GetDefaultDisplayResolutionChangeEvent ===
No input, returns an output Event handle with autoclear=true.


=== GetOperationModeSystemInfo ===
=== GetHdcpAuthenticationState ===
No input, returns an output u32.
No input, returns an output s32.


This returns the output from [[#GetOperationModeSystemInfo_2|omm GetOperationModeSystemInfo]].
=== GetHdcpAuthenticationStateChangeEvent ===
No input, returns an output Event handle with autoclear=true.


=== GetSettingsPlatformRegion ===
=== SetTvPowerStateMatchingMode ===
No input, returns an output u8.
Takes an input s32 [[#TvPowerStateMatchingMode]], no output.


This just returns the output from [[Settings_services#GetPlatformRegion|setsys GetPlatformRegion]].
=== GetApplicationIdByContentActionName ===
Takes a type-0x5 input buffer containing a string, returns an output [[NCM_services#ApplicationId|ApplicationId]].


=== ActivateMigrationService ===
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).
No input/output.
 
=== SetCpuBoostMode ===
Takes an input u32 [[#CpuBoostMode]] and passes it to [[PPC_services#apm:sys|SetCpuBoostMode]].
 
=== CancelCpuBoostMode ===
No input/output.
 
=== GetBuiltInDisplayType ===
No input, returns an output s32.
 
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]].
Besides various other functionality, if required this eventually uses [[NS_Services|ns]] LaunchLibraryApplet to launch [[Migration_services|migration]].
Line 2,352: Line 2,730:
|-
|-
| 2200 || [S2] SetSharingLayerEnabled
| 2200 || [S2] SetSharingLayerEnabled
|-
| 2300 || [S2] [20.0.0+] SetCopyrightLayerEnabled
|-
| 2400 || [S2] SetRtcScreenSharingAudioEnabled
|-
| 2401 || [S2] [20.0.0+] SetStreamPlayMirroringAudioEnabled
|-
| 2402 || [S2] [20.0.0+]
|}
|}


Line 2,997: Line 3,383:
! Cmd || Name
! Cmd || Name
|-
|-
| 0 ||  
| 1 ||  
|}
|}


=== Cmd0 ===
=== Cmd1 ===
No input. Returns an [[#IApplicationObserver]].
No input. Returns an [[#IApplicationObserver]].


Line 3,021: Line 3,407:
|-
|-
| 30 ||  
| 30 ||  
|-
| 40 || [S2] [20.0.0+]
|}
|}


Line 3,039: Line 3,427:
|}
|}


== IDebugFunctions ==
== IChatProxy ==
This is "nn::am::service::IDebugFunctions".
This is "nn::am::service::IChatProxy".
 
This is exclusive to Switch 2.


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
! Cmd || Name
! Cmd || Name || Notes
|-
|-
| 0 || [[#NotifyMessageToHomeMenuForDebug]]
| 0 || GetCommonStateGetter || Returns an [[#ICommonStateGetter]].
|-
|-
| 1 || [1.0.0-9.2.0] [[#OpenMainApplication]]
| 1 || GetSelfController || Returns an [[#ISelfController]].
|-
|-
| 10 || [[#PerformSystemButtonPressing]]
| 2 || GetWindowController || Returns an [[#IWindowController]].
|-
|-
| 20 || [[#InvalidateTransitionLayer]]
| 3 || GetAudioController || Returns an [[#IAudioController]].
|-
|-
| 30 || [6.0.0+] [[#RequestLaunchApplicationWithUserAndArgumentForDebug]]
| 4 || GetDisplayController || Returns an [[#IDisplayController]].
|-
|-
| 31 || [12.0.0+] [[#RequestLaunchApplicationByApplicationLaunchInfoForDebug]]
| 1000 || GetDebugFunctions || Returns an [[#IDebugFunctions]].
|-
|-
| 40 || [6.0.0+] [[#GetAppletResourceUsageInfo]]
| 10 || GetProcessWindingController || Returns an [[#IProcessWindingController]].
|-
|-
| 50 || [15.0.0+] AddSystemProgramIdAndAppletIdForDebug
| 11 || GetLibraryAppletCreator || Returns an [[#ILibraryAppletCreator]].
|-
|-
| 51 || [16.0.0+] AddOperationConfirmedLibraryAppletIdForDebug
| 20 || || Returns an [[#IChatFunctions]].
|}
 
=== IChatFunctions ===
This is "nn::am::service::IChatFunctions".
 
This is exclusive to Switch 2.
 
{| class="wikitable" border="1"
|-
|-
| 52 || [17.0.0+] GetProgramIdFromAppletIdForDebug
! Cmd || Name
|-
|-
| 53 || [18.0.0+] GetProgramIdFromAppletIdAndLibraryAppletModeForDebug
| 1 ||  
|-
|-
| 100 || [7.0.0+] [[#SetCpuBoostModeForApplet]]
| 102 ||  
|-
|-
| 101 || [10.0.0+] [[#CancelCpuBoostModeForApplet]]
| 103 ||  
|-
|-
| 110 || [9.0.0+] [[#PushToAppletBoundChannelForDebug]]
| 104 ||  
|-
|-
| 111 || [9.0.0+] [[#TryPopFromAppletBoundChannelForDebug]]
| 110 ||  
|-
|-
| 120 || [9.0.0+] [[#AlarmSettingNotificationEnableAppEventReserve]]
| 120 ||  
|-
|-
| 121 || [9.0.0+] [[#AlarmSettingNotificationDisableAppEventReserve]]
| 121 ||  
|-
| 130 ||
|-
|-
| 122 || [9.0.0+] [[#AlarmSettingNotificationPushAppEventNotify]]
| 140 || [20.0.0+]
|-
|-
| 130 || [9.0.0+] [[#FriendInvitationSetApplicationParameter]]
| 141 || [20.0.0+]
|-
|-
| 131 || [9.0.0+] [[#FriendInvitationClearApplicationParameter]]
| 200 ||  
|-
|-
| 132 || [9.0.0+] [[#FriendInvitationPushApplicationParameter]]
| 201 ||  
|-
|-
| 140 || [14.0.0+] [[#RestrictPowerOperationForSecureLaunchModeForDebug|RestrictPowerOperationForSecureLaunchModeForDebug]]
| 210 || [20.0.0+]
|-
|-
| 150 || [21.0.0+]
| 220 || [20.0.0+]
|}
 
== IDebugFunctions ==
This is "nn::am::service::IDebugFunctions".
 
{| class="wikitable" border="1"
|-
|-
| 200 || [15.0.0+] [[#CreateFloatingLibraryAppletAccepterForDebug|CreateFloatingLibraryAppletAccepterForDebug]]
! Cmd || Name
|-
|-
| 300 || [16.0.0+] TerminateAllRunningApplicationsForDebug
| 0 || [[#NotifyMessageToHomeMenuForDebug]]
|-
|-
| 400 || [S2]
| 1 || [1.0.0-9.2.0] [[#OpenMainApplication]]
|-
|-
| 401 || [S2]
| 10 || [[#PerformSystemButtonPressing]]
|-
|-
| 402 || [S2]
| 20 || [[#InvalidateTransitionLayer]]
|-
|-
| 403 || [S2]
| 30 || [6.0.0+] [[#RequestLaunchApplicationWithUserAndArgumentForDebug]]
|-
|-
| 410 || [18.0.0+] [[#CreateGeneralStorageForDebug|CreateGeneralStorageForDebug]]
| 31 || [12.0.0+] [[#RequestLaunchApplicationByApplicationLaunchInfoForDebug]]
|-
|-
| 411 || [18.0.0+] [[#ReadGeneralStorageForDebug|ReadGeneralStorageForDebug]]
| 40 || [6.0.0+] [[#GetAppletResourceUsageInfo]]
|-
|-
| 412 || [18.0.0+] [[#WriteGeneralStorageForDebug|WriteGeneralStorageForDebug]]
| 50 || [15.0.0+] AddSystemProgramIdAndAppletIdForDebug
|-
|-
| 430 || [20.0.0+]
| 51 || [16.0.0+] AddOperationConfirmedLibraryAppletIdForDebug
|-
|-
| 431 || [20.0.0+]
| 52 || [17.0.0+] GetProgramIdFromAppletIdForDebug
|-
|-
| 900 || [12.0.0+] GetGrcProcessLaunchedSystemEvent
| 53 || [18.0.0+] GetProgramIdFromAppletIdAndLibraryAppletModeForDebug
|-
|-
| 910 || [20.0.0+]
| 100 || [7.0.0+] [[#SetCpuBoostModeForApplet]]
|-
|-
| 2000 || [S2]
| 101 || [10.0.0+] [[#CancelCpuBoostModeForApplet]]
|-
|-
| 10000 || [S2]
| 110 || [9.0.0+] [[#PushToAppletBoundChannelForDebug]]
|}
|-
 
| 111 || [9.0.0+] [[#TryPopFromAppletBoundChannelForDebug]]
=== NotifyMessageToHomeMenuForDebug ===
|-
Takes an input [[#AppletMessage]], no output.
| 120 || [9.0.0+] [[#AlarmSettingNotificationEnableAppEventReserve]]
 
|-
Stubbed, just returns an error.
| 121 || [9.0.0+] [[#AlarmSettingNotificationDisableAppEventReserve]]
 
|-
=== OpenMainApplication ===
| 122 || [9.0.0+] [[#AlarmSettingNotificationPushAppEventNotify]]
No input, returns an output [[#IApplicationAccessor]].
|-
 
| 130 || [9.0.0+] [[#FriendInvitationSetApplicationParameter]]
Should not be used when no Application is running (svcBreak).
|-
 
| 131 || [9.0.0+] [[#FriendInvitationClearApplicationParameter]]
=== PerformSystemButtonPressing ===
|-
Takes an input [[#SystemButtonType]], no output.
| 132 || [9.0.0+] [[#FriendInvitationPushApplicationParameter]]
 
|-
=== InvalidateTransitionLayer ===
| 140 || [14.0.0+] [[#RestrictPowerOperationForSecureLaunchModeForDebug|RestrictPowerOperationForSecureLaunchModeForDebug]]
No input/output.
|-
 
| 150 || [21.0.0+]
=== 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.
| 200 || [15.0.0+] [[#CreateFloatingLibraryAppletAccepterForDebug|CreateFloatingLibraryAppletAccepterForDebug]]
 
|-
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]]).
| 300 || [16.0.0+] TerminateAllRunningApplicationsForDebug
|-
| 400 || [S2] LaunchDebugAppletForDebug
|-
| 401 || [S2] TerminateDebugAppletForDebug
|-
| 402 || [S2] IsDebugAppletLaunchedForDebug
|-
| 403 || [S2]
|-
| 410 || [18.0.0+] [[#CreateGeneralStorageForDebug|CreateGeneralStorageForDebug]]
|-
| 411 || [18.0.0+] [[#ReadGeneralStorageForDebug|ReadGeneralStorageForDebug]]
|-
| 412 || [18.0.0+] [[#WriteGeneralStorageForDebug|WriteGeneralStorageForDebug]]
|-
| 430 || [20.0.0+]
|-
| 431 || [20.0.0+]
|-
| 900 || [12.0.0+] GetGrcProcessLaunchedSystemEvent
|-
| 910 || [20.0.0+]
|-
| 2000 || [S2] [20.0.0+]
|-
| 10000 || [S2]
|}


=== RequestLaunchApplicationByApplicationLaunchInfoForDebug ===
=== NotifyMessageToHomeMenuForDebug ===
Takes a total of 0x58-bytes of input, a type-0x5 input buffer containing an array of 0x10-byte entries, and a type-0x5 input buffer. No output.
Takes an input [[#AppletMessage]], no output.


[19.0.0+] Takes a total of 0x88-bytes of input, a type-0x5 input buffer containing an array of 0x10-byte entries, and a type-0x5 input buffer. No output.
Stubbed, just returns an error.


=== GetAppletResourceUsageInfo ===
=== OpenMainApplication ===
No input, returns an output [[#AppletResourceUsageInfo]].
No input, returns an output [[#IApplicationAccessor]].


=== SetCpuBoostModeForApplet ===
Should not be used when no Application is running (svcBreak).
Takes an input u32 [[#CpuBoostMode]] 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.
=== PerformSystemButtonPressing ===
Takes an input [[#SystemButtonType]], no output.
 
=== InvalidateTransitionLayer ===
No input/output.
 
=== 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.
 
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]]).
 
=== RequestLaunchApplicationByApplicationLaunchInfoForDebug ===
Takes a total of 0x58-bytes of input, a type-0x5 input buffer containing an array of 0x10-byte entries, and a type-0x5 input buffer. No output.
 
[19.0.0+] Takes a total of 0x88-bytes of input, a type-0x5 input buffer containing an array of 0x10-byte entries, and a type-0x5 input buffer. No output.
 
=== GetAppletResourceUsageInfo ===
No input, returns an output [[#AppletResourceUsageInfo]].
 
=== SetCpuBoostModeForApplet ===
Takes an input u32 [[#CpuBoostMode]] 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.


=== CancelCpuBoostModeForApplet ===
=== CancelCpuBoostModeForApplet ===
Line 3,291: Line 3,745:
|-
|-
! Cmd || Name
! Cmd || Name
|-
| 2000 || [S2] [[#OpenCompatApplicationFunctions|OpenCompatApplicationFunctions]]
|-
|-
| 0 || [[#OpenApplicationProxy]]
| 0 || [[#OpenApplicationProxy]]
|-
| 10 || [S2] [[#OpenApplicationProxy2|OpenApplicationProxy2]]
|}
|}


Line 3,301: Line 3,759:


On failure, official user-processes will retry using this command in a loop while the retval is 0x19280, with svcSleepThread(10000000) being called first.
On failure, official user-processes will retry using this command in a loop while the retval is 0x19280, with svcSleepThread(10000000) being called first.
== OpenApplicationProxy2 ==
Unofficial name.
Takes an input u32, an u64 pid_reserved, a PID, and a process copy-handle (cur-proc handle alias). Returns an [[#IApplicationProxy]].


= idle:sys =
= idle:sys =
Line 3,529: Line 3,992:


This was added with [8.0.0+].
This was added with [8.0.0+].
[S2] Official sw no longer uses this (stubbed out).


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 3,773: Line 4,238:
Unofficial name.
Unofficial name.


No input. Returns an output TIPC handle to [[Switch_2:_GSV_services|GraphicsSupervisor]]..
No input. Returns an output TIPC handle to [[Switch_2:_GSV_services|GraphicsSupervisor]].


Same as [[#GetGraphicsSupervisor]] but for compat mode.
Same as [[#GetGraphicsSupervisor]] but for compat mode.
Line 3,901: Line 4,366:
|-
|-
| 0x00000013
| 0x00000013
| 0x010000000000100A
| [22.0.0+] 0x0100000000001043 ([1.0.0-21.2.0] 0x010000000000100A)
| [[Internet_Browser#010000000000100A|LibraryAppletWeb (web)]]
| [[Internet_Browser#010000000000100A|LibraryAppletWeb (web)]]
|-
|-
Line 3,921: Line 4,386:
|-
|-
| 0x00000018
| 0x00000018
| 0x0100000000001010
| [22.0.0+] 0x0100000000001042 ([1.0.0-21.2.0] 0x0100000000001010)
| [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]]
| [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]]
|-
|-
| 0x00000019
| 0x00000019
| 0x0100000000001011
| [22.0.0+] 0x0100000000001043 ([1.0.0-21.2.0] 0x0100000000001011)
| [[Internet_Browser#WifiWebAuthApplet|LibraryAppletWifiWebAuth (wifiWebAuth)]]
| [[Internet_Browser#WifiWebAuthApplet|LibraryAppletWifiWebAuth (wifiWebAuth)]]
|-
|-
Line 3,973: Line 4,438:
|-
|-
| 0x00000035
| 0x00000035
| [17.0.0+] 0x0100000000001010 ([16.0.0-16.1.0] 0x0100000000001042)
| [22.0.0+] 0x0100000000001042 ([17.0.0-21.2.0] 0x0100000000001010, [16.0.0-16.1.0] 0x0100000000001042)
| [17.0.0+] LibraryAppletLhub ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
| [17.0.0+] LibraryAppletLhub ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
|-
|-
| 0x00000036
| 0x00000036
| [17.0.0+] 0x0100000000001010 ([16.0.0-16.1.0] 0x0100000000001042)
| [22.0.0+] 0x0100000000001042 ([17.0.0-21.2.0] 0x0100000000001010, [16.0.0-16.1.0] 0x0100000000001042)
| [17.0.0+] LibraryAppletLogin ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
| [17.0.0+] LibraryAppletLogin ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
|-
|-
| 0x00000037
| 0x00000037
| [17.0.0+] 0x0100000000001010 ([16.0.0-16.1.0] 0x0100000000001042)
| [22.0.0+] 0x0100000000001042 ([17.0.0-21.2.0] 0x0100000000001010, [16.0.0-16.1.0] 0x0100000000001042)
| [17.0.0+] LibraryAppletShare ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
| [17.0.0+] LibraryAppletShare ([16.0.0-16.1.0] ) ([[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare (loginShare)]] in NX)
|-
|-
Line 3,995: Line 4,460:
| 0x0100000000001007
| 0x0100000000001007
| [18.0.0+]
| [18.0.0+]
|-
| 0x00000052
| 0x0100000000001001
| [22.0.0+]
|-
|-
| 0x00000064
| 0x00000064
| 0x0100000000001048
| 0x0100000000001048
| [20.0.0+] [[Splay_Applet|splay]]
| [20.0.0+] [[Splay_Applet|splay]]
|-
| 0x00000066
| 0x0100000000001054
| [21.0.0+]
|-
|-
| 0x000003E8
| 0x000003E8
Line 4,059: Line 4,532:
| 0x010000000000D60E
| 0x010000000000D60E
| [10.0.0-16.1.0] AppletILA2
| [10.0.0-16.1.0] AppletILA2
|-
| 0x0100000A
|
| [[Auth_Applet|LibraryAppletAuth]]
|-
| 0x0100000B
|
| [[Cabinet_Applet|LibraryAppletCabinet]]
|-
| 0x0100000C
|
| [[Controller_Applet|LibraryAppletController]]
|-
| 0x0100000D
|
| [S2]
|-
|-
| 0x0100000E
| 0x0100000E
Line 4,076: Line 4,565:
| [S2] Swkbd
| [S2] Swkbd
|-
|-
| 0x01000013
| 0x01010012
|  
|
| [S2] OpenWeb
| [S2] [[MiiEdit_Applet|LibraryAppletMiiEdit]] (for ShowMiiEdit)
|-
|-
| 0x01000014
| 0x01020012
|  
|
| [S2] LibraryAppletShop
| [S2] [[MiiEdit_Applet|LibraryAppletMiiEdit]] (for AppendMii)
|-
|-
| 0x01000022
| 0x01070012
|  
|
| [S2] LibraryAppletPromoteQualification
| [S2] [[MiiEdit_Applet|LibraryAppletMiiEdit]] (for CreateMii)
|-
|-
| 0x01010025
| 0x01080012
|  
|
| [S2] SaveDataBackup
| [S2] [[MiiEdit_Applet|LibraryAppletMiiEdit]] (for EditMii)
|-
|-
| 0x01020025
| 0x01000013
|  
|  
| [S2] SaveDataBackup
| [S2] OpenWeb
|-
|-
| 0x01000032
| 0x01000014
|  
|  
| [S2] LibraryAppletOfflineWebApp_3
| [S2] LibraryAppletShop
|-
|-
| 0x01000033
| 0x01000015
|
| [S2] [[Album_Applet|Album]]
|-
| 0x01000017
|
| [S2] LibraryAppletOffline (for Gen0)
|-
| 0x01000018
|
| [S2] [[Internet_Browser#Whitelisted_Applets|LibraryAppletLoginShare]] (for Lobby)
|-
| 0x0100001A
|
| [S2] [[MyPage_Applet|MyPageApplet]]
|-
| 0x01000022
|  
| [S2] LibraryAppletPromoteQualification
|-
| 0x01000024
|
| [S2] SplayApplet
|-
| 0x01030024
|
| [S2] SplayApplet
|-
| 0x01010025
|  
| [S2] SaveDataBackup (System Settings menu for Save Data Cloud)
|-
| 0x01020025
|  
| [S2] SaveDataBackup (Same as above except with ApplicationId specified)
|-
| 0x01000028
|
| [S2] Eula
|-
| 0x01000032
|  
| [S2] LibraryAppletOfflineWebApp_3
|-
| 0x01000033
|
| [S2] LibraryAppletOfflineWebSystem
|-
| 0x01000035
|
| [S2] LibraryAppletLhub
|-
| 0x01000036
|
| [S2] LibraryAppletLogin
|-
| 0x01000037
|
| [S2] LibraryAppletShare
|-
| 0x01000050
|
| [S2] PlayerSelect
|-
| 0x01000051
|
| [S2] PlayerSelect
|-
| 0x01000052
|
| [S2] PlayerSelect
|-
| 0x01000065
|  
|  
| [S2] LibraryAppletOfflineWebSystem
| [S2] Chat (ForChatStart)
|-
|-
| 0x01000035
| 0x01010065
|  
|  
| [S2] LibraryAppletLhub
| [S2] Chat (ForCameraConfiguration)
|-
|-
| 0x01000036
| 0x01020065
|  
|  
| [S2] LibraryAppletLogin
| [S2] Chat (ForFullScreen)
|-
|-
| 0x01000037
| 0x01030065
|  
|  
| [S2] LibraryAppletShare
| [S2] Chat (ForCameraSharingGuide)
|-
| 0x01000050
|
| [S2] PlayerSelect
|-
| 0x01000051
|
| [S2] PlayerSelect
|-
| 0x01000052
|
| [S2] PlayerSelect
|-
|-
| 0x700000C8
| 0x700000C8
Retrieved from "https://switchbrew.org/wiki/Applet_Manager_services"