PMApp:LaunchTitle: Difference between revisions

From 3dbrew
Jump to navigation Jump to search
Steveice10 (talk | contribs)
m Add initial launch table.
Steveice10 (talk | contribs)
 
(7 intermediate revisions by the same user not shown)
Line 9: Line 9:
|-
|-
| 1-4
| 1-4
| [[FSReg:LoadProgram#ProgramInfo|ProgramInfo struct]]
| [[Filesystem_services#ProgramInfo|Program Info]]
|-
|-
| 5
| 5
Line 26: 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=
=Launch Flags=
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!  Bit
!  Bit Mask
!  Bit Mask
!  Description
!  Description
|-
|-
| 0
| 0x1
| 0x1
| ?
| Normal application.
|-
|-
| 1
| 0x2
| 0x2
| Load dependencies
| Load [[NCCH/Extended_Header|exheader]] dependencies.
|-
|-
| 2
| 0x4
| 0x4
| ?
| On termination, publish [[Services#Notifications|SRV notification]] "0x110 + (value in bits 4-7)".
|-
|-
| 3
| 0x8
| 0x8
| Queue Execution
| Queue execution until [[PMDbg:RunQueuedProcess|RunQueuedProcess]] call.
|-
| 4-7
| 0xF0
| Variation of signal 0x110 to send if bit 2 (0x4) is set.
|-
|-
| 16
| 0x10000
| 0x10000
| Use update title
| Use update title if through [[PMApp:LaunchTitleUpdate|LaunchTitleUpdate]]. Otherwise has no use.
|}
|}

Latest revision as of 04:59, 20 January 2016

Request

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

Response

Index Word Description
0 Header code
1 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

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.