SRV:RegisterService: Difference between revisions
Jump to navigation
Jump to search
Add details about semantics of call |
Convert to IPC templates |
||
| Line 1: | Line 1: | ||
=Request= | =Request= | ||
{| | {{IPC/Request|Request}} | ||
| | {{IPC/RequestHeader|0x0003|4|0}} | ||
{{IPC/RequestEntryRange|2|8-byte UTF-8 service name}} | |||
{{IPC/RequestEntry|Name length}} | |||
| | {{IPC/RequestEntry|Maximum sessions}} | ||
| 0 | {{IPC/RequestEnd}} | ||
| | |||
| 8-byte UTF-8 service name | |||
| Name length | |||
| Maximum sessions | |||
=Response= | =Response= | ||
{| | {{IPC/Request|Response}} | ||
| | {{IPC/RequestHeader|0x0003|1|2}} | ||
{{IPC/RequestEntry|Result code}} | |||
{{IPC/MoveHandle|1}} | |||
| | {{IPC/MoveHandleEntry|<code>Handle<[[KServerPort]]></code> which will receive incoming connections to the service.}} | ||
| | {{IPC/RequestEnd}} | ||
| | |||
| 1 | |||
| | |||
This function registers a new service which can be accessed using [[SRV:GetServiceHandle]]. The service manager will create a new client-server port pair, registering the [[KPort|client endpoint]] under the given name, and returning the [[KServerPort|server endpoint]] for the service to listen on for incoming connections. | This function registers a new service which can be accessed using [[SRV:GetServiceHandle]]. The service manager will create a new client-server port pair, registering the [[KPort|client endpoint]] under the given name, and returning the [[KServerPort|server endpoint]] for the service to listen on for incoming connections. | ||
Latest revision as of 13:54, 18 September 2024
Request
| Request Word | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 0 |
| ||||||||
| 1-2 | 8-byte UTF-8 service name | ||||||||
| 3 | Name length | ||||||||
| 4 | Maximum sessions |
Response
| Response Word | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 0 |
| ||||||||
| 1 | Result code | ||||||||
| 2 | Descriptor for moving 1 handle | ||||||||
| 3 | Handle<KServerPort> which will receive incoming connections to the service.
|
This function registers a new service which can be accessed using SRV:GetServiceHandle. The service manager will create a new client-server port pair, registering the client endpoint under the given name, and returning the server endpoint for the service to listen on for incoming connections.