winamp/Src/replicant/application/api_application.h

63 lines
2.8 KiB
C++

#pragma once
#include "../replicant/foundation/dispatch.h"
#include "../replicant/foundation/error.h"
#include "../replicant/service/types.h"
#include "../replicant/nx/nxuri.h"
// {23B96771-09D7-46d3-9AE2-20DCEA6C86EA}
static const GUID applicationApiServiceGuid =
{
0x23b96771, 0x9d7, 0x46d3, { 0x9a, 0xe2, 0x20, 0xdc, 0xea, 0x6c, 0x86, 0xea }
};
// ----------------------------------------------------------------------------
class api_application: public Wasabi2::Dispatchable
{
protected:
api_application() : Dispatchable(DISPATCHABLE_VERSION) {}
~api_application() {}
public:
static GUID GetServiceType() { return SVC_TYPE_UNIQUE; }
static GUID GetServiceGUID() { return applicationApiServiceGuid; }
const char *GetUserAgent() { return Application_GetUserAgent(); }
/* returns a path where you can store data files, if you need to */
int GetDataPath(nx_uri_t *path) { return Application_GetDataPath(path); }
/* checks whether or not a particular feature has permissions to operate.
returns NErr_True or NErr_False. see features.h for known GUIDs */
int GetPermission(GUID feature) { return Application_GetPermission(feature); }
/* checks whether or not a particular feature is available.
This only includes some features that might be absent based on OS version, hardware support, or third party dependencies
It's meant for code that is otherwise unable to easily check directly or via other methods (e.g. WASABI2_API_SVC->GetService)
returns NErr_True or NErr_False. see features.h for known GUIDs */
int GetFeature(GUID feature) { return Application_GetFeature(feature); }
/* used by a component to set features that are available. See notes above for GetFeature
for thread-safety, you should only call this during your RegisterServices() function
(or during application init if you are hosting Wasabi) */
void SetFeature(GUID feature) { Application_SetFeature(feature); }
unsigned int GetBuildNumber() { return Application_GetBuildNumber(); }
int GetVersionString(nx_string_t *version) { return Application_GetVersionString(version); }
int GetProductShortName(nx_string_t *name) { return Application_GetProductShortName(name); }
int GetDeviceID(nx_string_t *value) { return Application_GetDeviceID(value); }
enum
{
DISPATCHABLE_VERSION,
};
protected:
virtual const char * Application_GetUserAgent()=0;
virtual int Application_GetDataPath(nx_uri_t *path)=0;
virtual int Application_GetPermission(GUID feature)=0;
virtual int Application_GetFeature(GUID feature)=0;
virtual void Application_SetFeature(GUID feature)=0;
virtual unsigned int Application_GetBuildNumber() { return 0; }
virtual int Application_GetVersionString(nx_string_t *version)=0;
virtual int Application_GetProductShortName(nx_string_t *name)=0;
virtual int Application_GetDeviceID(nx_string_t *value)=0;
};