Difference between revisions of "ACTU:Initialize"

From 3dbrew
Jump to navigation Jump to search
(Created page with "=Request= {| class="wikitable" border="1" |- ! Index Word ! Description |- | 0 | Header code [0x00010084] |- | 1 | SDK Version |- | 2 | Shared memory size |- | 3 | Always 0x...")
 
m (TimmSkiller moved page ACT:Initialize to ACTU:Initialize)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
=Request=
 
=Request=
{| class="wikitable" border="1"
+
{{IPC/Request}}
|-
+
{{IPC/RequestHeader|0x0001|2|4}}
!  Index Word
+
{{IPC/RequestEntry|SDK Version}}
!  Description
+
{{IPC/RequestEntry|u32, Shared memory size (optional)}}
|-
+
{{IPC/ProcessID}}
| 0
+
{{IPC/CopyHandle|1}}
| Header code [0x00010084]
+
{{IPC/CopyHandleEntry|Handle to shared memory (optional)}}
|-
+
{{IPC/RequestEnd}}
| 1
 
| SDK Version
 
|-
 
| 2
 
| Shared memory size
 
|-
 
| 3
 
| Always 0x20(kernel PID header)
 
|-
 
| 4
 
| 0x20(The code to request the current process handle.)
 
|-
 
| 5
 
| 0x00 (handle-transfer header for kernel)
 
|-
 
| 6
 
| Shared memory address value.
 
|}
 
  
 
=Response=
 
=Response=
{| class="wikitable" border="1"
+
{{IPC/Request}}
|-
+
{{#vardefine:ipc_offset|0}}
!  Index Word
+
{{IPC/RequestHeader|0x0001|1|0}}
!  Description
+
{{IPC/RequestEntry|Result code}}
|-
+
{{IPC/RequestEnd}}
| 0
 
| Header code
 
|-
 
| 1
 
| Result code
 
|}
 
  
 
=Description=
 
=Description=
This initializes the ACT service. Shared memory initialization is optional, but some service calls require it.
+
Initializes the current session.
 +
 
 +
The process ID is used to obtain the Title ID and Remaster Version of the caller.
 +
 
 +
An optional block of extra memory can be shared with the act service. The caller must create a memory block and specify its size in this request. If used, the act service will map the memory block into its own address space and use it as an extra heap. This extra memory is required for certain commands.

Latest revision as of 17:46, 12 January 2025

Request[edit]

Index Word Description
0
Header 0x00010084 Cmd 0x0001 Param 2 Xlat 4
1 SDK Version
2 u32, Shared memory size (optional)
3 Descriptor for process ID
4 Placeholder for process ID
5 Descriptor for copying 1 handle
6 Handle to shared memory (optional)

Response[edit]

Index Word Description
0
Header 0x00010040 Cmd 0x0001 Param 1 Xlat 0
1 Result code

Description[edit]

Initializes the current session.

The process ID is used to obtain the Title ID and Remaster Version of the caller.

An optional block of extra memory can be shared with the act service. The caller must create a memory block and specify its size in this request. If used, the act service will map the memory block into its own address space and use it as an extra heap. This extra memory is required for certain commands.