Difference between revisions of "APT:PrepareToStartApplication"

From 3dbrew
Jump to navigation Jump to search
m (Update link.)
m (Link to FS common program info.)
Line 9: Line 9:
 
|-
 
|-
 
| 1-4
 
| 1-4
| [[FSReg:LoadProgram#ProgramInfo|ProgramInfo struct]]
+
| [[Filesystem_services#ProgramInfo|Program Info]]
 
|-
 
|-
 
| 5
 
| 5

Revision as of 23:51, 17 October 2015

Request

Index Word Description
0 Header code [0x00150140]
1-4 Program Info
5 u8(changed to u32 with 8.0.0-18) flags, usually zero. When zero, NS writes a title-info struct with programID=~0 and mediatype=NAND to the FIRM parameters structure.

Response

Index Word Description
0 Header code
1 Result code

Description

When the input title-info programID is zero, NS will load the actual programID via AMNet:GetTitleIDList. After doing some checks with the programID, NS will then set a NS state flag to value 1, then set the programID for AppID 0x300(application) to the input programID(or the one from GetTitleIDList). A mediatype field in NS state is also set to the input mediatype value(other state fields are set at this point as well).

With 8.0.0-18, NS will set an u8 NS state field to value 1 when input flags bit8 is set. This is used with the PTMSYSM 0x040A0000 command code in NS, mentioned here. Note that the value of that NS state field is unreliable: as of the Home Menu version for system-version 9.8.0-25 the Home Menu code still writes to the flags field for this APT:PrepareToStartApplication command with an u8. Hence, the bit8 value that gets sent to NS is whatever was previously stored in the Home Menu thread-local-storage.