summaryrefslogtreecommitdiffstats
path: root/src/core/hle/kernel/client_port.h
blob: ee65606ba2842cf9a67eb9430029a332e66c0b5b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
// Copyright 2016 Citra Emulator Project
// Licensed under GPLv2 or any later version
// Refer to the license.txt file included.

#pragma once

#include <string>
#include <memory>
#include "common/common_types.h"
#include "core/hle/kernel/kernel.h"

namespace Service {
class Interface;
}

namespace Kernel {

class ServerPort;
class ServerSession;

class ClientPort final : public Object {
public:
    friend class ServerPort;

    /**
     * Creates a serverless ClientPort that represents a bridge between the HLE implementation of a service/port and the emulated application.
     * @param max_sessions Maximum number of sessions that this port is able to handle concurrently.
     * @param hle_interface Interface object that implements the commands of the service.
     * @returns ClientPort for the given HLE interface.
     */
    static Kernel::SharedPtr<ClientPort> CreateForHLE(u32 max_sessions, std::unique_ptr<Service::Interface> hle_interface);

    /**
     * Adds the specified server session to the queue of pending sessions of the associated ServerPort
     * @param server_session Server session to add to the queue
     */
    virtual void AddWaitingSession(SharedPtr<ServerSession> server_session);

    /**
     * Handle a sync request from the emulated application.
     * @returns ResultCode from the operation.
     */
    ResultCode HandleSyncRequest();

    std::string GetTypeName() const override { return "ClientPort"; }
    std::string GetName() const override { return name; }

    static const HandleType HANDLE_TYPE = HandleType::ClientPort;
    HandleType GetHandleType() const override {
        return HANDLE_TYPE;
    }

    SharedPtr<ServerPort> server_port = nullptr;                 ///< ServerPort associated with this client port.
    u32 max_sessions;                                            ///< Maximum number of simultaneous sessions the port can have
    u32 active_sessions;                                         ///< Number of currently open sessions to this port
    std::string name;                                            ///< Name of client port (optional)
    std::unique_ptr<Service::Interface> hle_interface = nullptr; ///< HLE implementation of this port's request handler

private:
    ClientPort();
    ~ClientPort() override;
};

} // namespace