Difference between revisions of "SRV:RegisterService"
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[edit]
| Request Word | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 0 |
| ||||||||
| 1-2 | 8-byte UTF-8 service name | ||||||||
| 3 | Name length | ||||||||
| 4 | Maximum sessions |
Response[edit]
| 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.