LDN services: Difference between revisions

Line 379:

This is used immediately after object creation.

With [7.0.0+] [[#InitializeWithVersion|InitializeWithVersion]] is used instead. The cmd impl for Initialize uses [[#InitializeWithVersion|InitializeWithVersion]] with ~~input_u32~~=0.

With [7.0.0+] [[#InitializeWithVersion|InitializeWithVersion]] is used instead. The cmd impl for Initialize uses [[#InitializeWithVersion|InitializeWithVersion]] with version=0.

=== Finalize ===

Line 398:

=== InitializeWithVersion ===

Takes an input PID, ~~an u32~~, and an u64 pid_placeholder.

Takes an input PID, a s32 version, and an u64 pid_placeholder.

Official sw uses hard-coded value 0x1 for the ~~u32~~.

Official sw uses hard-coded value 0x1 for the version.

The ~~input u32 is ignored, the impl for this cmd is identical to [[#Initialize_2|Initialize]]~~.

The version must not be negative.

Internally this calls a func with params: (..., PID, &{u16 value 0x38}). On success, this then calls another func (which sets two state fields to the input) with params: (state, 0) (these state fields are used during [[#Authentication]] to check which service is being used).

Line 411:

=== InitializeWithPriority ===

Takes an input PID, ~~an u32~~, an u32, and an u64 pid_placeholder.

Takes an input PID, a s32 version, an u32, and an u64 pid_placeholder.

This is similar to [[#InitializeWithVersion|InitializeWithVersion]], with the additional cmd input u32 now being passed directly to the init func which is called here.

Line 615:

=== InitializeWithVersion ===

Takes an input PID, ~~an u32~~, and an u64 pid_placeholder.

Takes an input PID, a s32, and an u64 pid_placeholder.

Official sw uses ~~hard-coded value 0x1 for~~ the ~~u32.~~

Official sw uses the same input value as with [[#InitializeWithVersion|InitializeWithVersion]].

~~The~~ input ~~u32 is ignored, the impl for this cmd is identical to~~ [[#~~Initialize_3~~|~~Initialize~~]].

This is identical to [[#InitializeWithVersion|InitializeWithVersion]] except different params are used for the funcs called internally: the u16 value is 0x5A, and the value for the second func is 1.

@@ Line 379: / Line 379: @@
 This is used immediately after object creation.
-With [7.0.0+] [[#InitializeWithVersion|InitializeWithVersion]] is used instead. The cmd impl for Initialize uses [[#InitializeWithVersion|InitializeWithVersion]] with input_u32=0.
+With [7.0.0+] [[#InitializeWithVersion|InitializeWithVersion]] is used instead. The cmd impl for Initialize uses [[#InitializeWithVersion|InitializeWithVersion]] with version=0.
 === Finalize ===
@@ Line 398: / Line 398: @@
 === InitializeWithVersion ===
-Takes an input PID, an u32, and an u64 pid_placeholder.
+Takes an input PID, a s32 version, and an u64 pid_placeholder.
-Official sw uses hard-coded value 0x1 for the u32.
+Official sw uses hard-coded value 0x1 for the version.
-The input u32 is ignored, the impl for this cmd is identical to [[#Initialize_2|Initialize]].
+The version must not be negative.
 Internally this calls a func with params: (..., PID, &{u16 value 0x38}). On success, this then calls another func (which sets two state fields to the input) with params: (state, 0) (these state fields are used during [[#Authentication]] to check which service is being used).
@@ Line 411: / Line 411: @@
 === InitializeWithPriority ===
-Takes an input PID, an u32, an u32, and an u64 pid_placeholder.
+Takes an input PID, a s32 version, an u32, and an u64 pid_placeholder.
 This is similar to [[#InitializeWithVersion|InitializeWithVersion]], with the additional cmd input u32 now being passed directly to the init func which is called here.
@@ Line 615: / Line 615: @@
 === InitializeWithVersion ===
-Takes an input PID, an u32, and an u64 pid_placeholder.
+Takes an input PID, a s32, and an u64 pid_placeholder.
-Official sw uses hard-coded value 0x1 for the u32.
+Official sw uses the same input value as with [[#InitializeWithVersion|InitializeWithVersion]].
-The input u32 is ignored, the impl for this cmd is identical to [[#Initialize_3|Initialize]].
 This is identical to [[#InitializeWithVersion|InitializeWithVersion]] except different params are used for the funcs called internally: the u16 value is 0x5A, and the value for the second func is 1.