aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/core/hle/applets/applet.h
blob: 221348d9c33a60ec66fecd0c95a9d1917d1d8ace (plain)
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
// Copyright 2015 Citra Emulator Project
// Licensed under GPLv2 or any later version
// Refer to the license.txt file included.

#pragma once

#include "common/common_types.h"
#include "core/hle/kernel/kernel.h"
#include "core/hle/kernel/shared_memory.h"
#include "core/hle/service/apt/apt.h"

namespace HLE {
namespace Applets {

class Applet {
public:
    virtual ~Applet() {};
    Applet(Service::APT::AppletId id) : id(id) {};

    /**
     * Creates an instance of the Applet subclass identified by the parameter
     * and stores it in a global map.
     * @param id Id of the applet to create
     * @returns ResultCode Whether the operation was successful or not
     */
    static ResultCode Create(Service::APT::AppletId id);

    /**
     * Retrieves the Applet instance identified by the specified id
     * @param id Id of the Applet to retrieve
     * @returns Requested Applet or nullptr if not found
     */
    static std::shared_ptr<Applet> Get(Service::APT::AppletId id);

    /**
     * Handles a parameter from the application
     * @param parameter Parameter data to handle
     * @returns ResultCode Whether the operation was successful or not
     */
    virtual ResultCode ReceiveParameter(Service::APT::MessageParameter const& parameter) = 0;

    /**
     * Handles the Applet start event, triggered from the application
     * @param parameter Parameter data to handle
     * @returns ResultCode Whether the operation was successful or not
     */
    virtual ResultCode Start(Service::APT::AppletStartupParameter const& parameter) = 0;

    Service::APT::AppletId id; ///< Id of this Applet
};

}
} // namespace