Difference between revisions of "PMApp:LaunchTitle"

From 3dbrew
Jump to navigation Jump to search
 
(10 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
| Header code [0x00010140]
 
| Header code [0x00010140]
 
|-
 
|-
| 1
+
| 1-4
| TitleID lower word
+
| [[Filesystem_services#ProgramInfo|Program Info]]
|-
 
| 2
 
| TitleID upper word
 
|-
 
| 3
 
| Unknown
 
|-
 
| 4
 
| Unknown
 
 
|-
 
|-
 
| 5
 
| 5
Line 35: Line 26:
 
| 1
 
| 1
 
| Result code
 
| Result code
 +
|-
 +
| 2
 +
| Process ID (set only if flag 0x1 not set)
 +
|}
 +
 +
=Description=
 +
This launches the specified title.
 +
 +
This returns result code 0xC8A05801 if [[PMApp:PrepareForReboot]] has been called, and 0xC8A05BF0 if the application flag is set and an application is already running.
 +
 +
=Launch Flags=
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Bit
 +
!  Bit Mask
 +
!  Description
 +
|-
 +
| 0
 +
| 0x1
 +
| Normal application.
 +
|-
 +
| 1
 +
| 0x2
 +
| Load [[NCCH/Extended_Header|exheader]] dependencies.
 +
|-
 +
| 2
 +
| 0x4
 +
| On termination, publish [[Services#Notifications|SRV notification]] "0x110 + (value in bits 4-7)".
 +
|-
 +
| 3
 +
| 0x8
 +
| Queue execution until [[PMDbg:RunQueuedProcess|RunQueuedProcess]] call.
 +
|-
 +
| 4-7
 +
| 0xF0
 +
| Variation of signal 0x110 to send if bit 2 (0x4) is set.
 +
|-
 +
| 16
 +
| 0x10000
 +
| Use update title if through [[PMApp:LaunchTitleUpdate|LaunchTitleUpdate]]. Otherwise has no use.
 
|}
 
|}

Latest revision as of 03:59, 20 January 2016

Request[edit]

Index Word Description
0 Header code [0x00010140]
1-4 Program Info
5 Process launch flags

Response[edit]

Index Word Description
0 Header code
1 Result code
2 Process ID (set only if flag 0x1 not set)

Description[edit]

This launches the specified title.

This returns result code 0xC8A05801 if PMApp:PrepareForReboot has been called, and 0xC8A05BF0 if the application flag is set and an application is already running.

Launch Flags[edit]

Bit Bit Mask Description
0 0x1 Normal application.
1 0x2 Load exheader dependencies.
2 0x4 On termination, publish SRV notification "0x110 + (value in bits 4-7)".
3 0x8 Queue execution until RunQueuedProcess call.
4-7 0xF0 Variation of signal 0x110 to send if bit 2 (0x4) is set.
16 0x10000 Use update title if through LaunchTitleUpdate. Otherwise has no use.